Extract_TP_Name (CPI-C)

Artikel
10/14/2023

Der Extract_TP_Name-Aufruf (Funktionsname cmetpn) gibt das TP_name Merkmal zurück.

Syntax

  
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              
);

Parameter

conversation_ID
Angegebener Parameter. Gibt den Bezeichner für die Unterhaltung an. Der Wert dieses Parameters wurde von Initialize_Conversation oder Accept_Conversation zurückgegeben.

TP_name
Zurückgegebener Parameter. Gibt die Variable an, die den Namen des Transaktionsprogramms (TP) enthält.

TP_name_length
Zurückgegebener Parameter. Gibt die Länge des TP-Namens an.

return_code
Der von diesem Aufruf zurückgegebene Code. Die gültigen Rückgabecodes werden weiter unten in diesem Thema aufgeführt.

Rückgabecodes

CM_OK
Primärer Rückgabecode; der Aufruf wurde erfolgreich ausgeführt.

CM_PROGRAM_PARAMETER_CHECK
Primärer Rückgabecode; Der durch conversation_ID angegebene Wert ist ungültig.

CM_PRODUCT_SPECIFIC_ERROR
Primärer Rückgabecode; Ein produktspezifischer Fehler ist aufgetreten und wurde im Produktfehlerprotokoll protokolliert.

Zustandsänderungen

Die Unterhaltung kann sich in einem beliebigen Zustand mit Ausnahme von RESET befinden.

Es gibt keine Zustandsänderung.

Hinweise

Bei einem aufrufenden Programm ist das TP_name Merkmal der Wert in den Seiteninformationen, auf die im sym_dest_name-Parameter des Initialize_Conversation-Aufrufs verwiesen wird. Für ein aufrufbares Programm ist dies der Name, der in der Unterhaltungsstartanforderung angegeben ist (der mit einem lokal oder in einem Specify_Local_TP_Name Aufruf angegebenen Namen abgeglichen wurde) und entspricht daher dem TP_name Merkmal des Partnerprogramms.

Der zurückgegebene Name kann bis zu 64 Bytes lang sein.

Freigeben über