Get_Attribute_Single : obtention d'un attribut d'un objet
Ce bloc fonction renvoie le contenu d'un attribut spécifique d'une instance d'objet.
Pour utiliser le bloc fonction, vous devez ajouter au moins un équipement EtherNet/IP dans le Gestionnaire de protocole. Reportez-vous à la section Ajout d'un équipement.
Le tableau suivant décrit la variable d'entrée :
|
Entrée |
Type de données |
Commentaire |
|---|---|---|
|
i_xExecute |
BOOL |
Plage de valeurs : FALSE, TRUE. Valeur par défaut : FALSE. Un front montant de l'entrée Execute démarre le bloc fonction. Le bloc fonction poursuit son exécution et la sortie Busy prend la valeur TRUE. oFALSE : si Enable est associé à la valeur FALSE, les sorties Done, Error ou CommandAborted ont la valeur TRUE pendant un cycle. oTRUE : si Enable est associé à la valeur FALSE, les sorties Done, Error ou CommandAborted conservent la valeur TRUE. |
|
i_xAbort |
BOOL |
Plage de valeurs : FALSE, TRUE. Valeur par défaut : FALSE. oFALSE : l'exécution n'a pas été interrompue. oTRUE : l'exécution a été interrompue par un autre bloc fonction. |
|
i_xMsgType |
BOOL |
oFALSE : UCCM oTRUE : message (classe 3) connecté |
|
i_adTargetIP |
TCP_ADDR |
Adresse IP de la cible. |
|
i_dwClass |
DWORD |
Classe cible. Consultez la section Comment trouver les informations de l'objet dans la documentation de l'équipement. Si la classe ne fait pas partie de la requête, il s'agit de 0xFFFFFFFF. |
|
i_dwInstance |
DWORD |
Instance cible. Consultez la section Comment trouver les informations de l'objet dans la documentation de l'équipement. Si la cible est une instance de classe, elle peut correspondre à 0. Si l'instance ne fait pas partie de la requête, il s'agit de 0xFFFFFFFF. |
|
i_dwAttribute |
DWORD |
Attribut cible. Consultez la section Comment trouver les informations de l'objet dans la documentation de l'équipement. Si l'attribut ne fait pas partie de la requête, il s'agit de 0xFFFFFFFF. |
Le tableau suivant décrit la variable de sortie :
|
Sortie |
Type de données |
Commentaire |
|---|---|---|
|
q_xDone |
BOOL |
Plage de valeurs : FALSE, TRUE. Valeur par défaut : FALSE. oFALSE : l'exécution n'a pas encore commencé ou une erreur a été détectée. oTRUE : exécution terminée sans erreur détectée. |
|
q_xBusy |
BOOL |
Plage de valeurs : FALSE, TRUE. Valeur par défaut : FALSE. oFALSE : le bloc fonction n'est pas exécuté. oTRUE : le bloc fonction est en cours d'exécution. |
|
q_xAborted |
BOOL |
Plage de valeurs : FALSE, TRUE. Valeur par défaut : FALSE. oFALSE : l'exécution n'a pas été interrompue. oTRUE : l'exécution a été interrompue par l'entrée Abort. |
|
q_xError |
BOOL |
Plage de valeurs : FALSE, TRUE. Valeur par défaut : FALSE. oFALSE : le bloc fonction est en cours d'exécution et aucune erreur n'a été détectée. oTRUE : une erreur a été détectée pendant l'exécution du bloc fonction. |
|
q_byCommError |
BYTE |
Donne des informations sur l'erreur détectée. |
|
q_dwOperError |
DWORD |
Donne des informations sur l'erreur détectée. |
|
q_abyResponseData |
ARRAY OF BYTE 0 à MAX_EIP_REQUEST_DATA_SIZE |
Données de réponse en cas de réussite. |
|
q_wDataSize |
WORD |
Taille des données de réponse en octets. |
