Extract_TP_Name (CPI-C)

L’appel Extract_TP_Name (nom de fonction cmetpn) retourne la caractéristique TP_name .

Syntaxe

  
CM_ENTRY Extract_TP_Name(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *TP_name,            
  CM_INT32 FAR *TP_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.

TP_name
Paramètre retourné. Spécifie la variable contenant le nom du programme de transaction (TP).

TP_name_length
Paramètre retourné. Spécifie la longueur du nom du TP.

return_code
Code retourné à partir de 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é consigné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

Dans le cas d’un programme appelant, la caractéristique TP_name est la valeur dans les informations latérales référencées dans le paramètre sym_dest_name de l’appel de Initialize_Conversation . Pour un programme programmes appelables, il s’agit du nom spécifié dans la demande de démarrage de la conversation (qui aura été mis en correspondance avec un nom spécifié localement ou dans un appel Specify_Local_TP_Name ) et sera donc identique à la caractéristique TP_name du programme partenaire.

La longueur du nom retourné peut atteindre jusqu’à 64 octets.