Extract_Partner_LU_Name (CPI-C)

L’appel Extract_Partner_LU_Name (nom de la fonction cmepln) retourne le nom de l’unité logique partenaire et la longueur du nom de l’unité logique partenaire pour une conversation spécifiée. Il peut s’agir d’un nom d’alias d’un maximum de huit octets ou d’un nom réseau complet de 17 octets maximum.

Syntaxe

  
CM_ENTRY Extract_Partner_LU_Name(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *partner_LU_name,    
  CM_INT32 FAR *partner_LU_name_length,    
  CM_INT32 FAR *return_code              
);  

Paramètres

conversation_ID
Paramètre fourni. Spécifie l’identificateur de la conversation. La valeur de ce paramètre a été retournée par Initialize_Conversation ou Accept_Conversation.

partner_LU_name
Paramètre retourné. Spécifie la variable contenant le nom de l’unité logique partenaire. (Le programme doit fournir un pointeur vers une variable appropriée.)

partner_LU_name_length
Paramètre retourné. Spécifie la longueur du nom de l’unité logique partenaire.

return_code
Code retourné par cet appel. Les codes de retour valides sont répertoriés plus loin dans cette rubrique.

Codes de retour

CM_OK
Code de retour principal ; l’appel a été exécuté avec succès.

CM_PROGRAM_PARAMETER_CHECK
Code de retour principal ; la valeur spécifiée par conversation_ID n’est pas valide.

CM_PRODUCT_SPECIFIC_ERROR
Code de retour principal ; une erreur spécifique au produit s’est produite et a été enregistrée dans le journal des erreurs des produits.

Changements d'état

La conversation peut être dans n’importe quel état à l’exception de RESET.

Il n’y a aucun changement d’état.

Remarques

Un programme de transaction CPI-C invocable ne recevra le nom de réseau complet qu’à l’issue de cet appel de fonction. Un TP CPI-C invocable ne peut pas récupérer le nom de l’alias à l’aide de cet appel.