Extract_Partner_LU_Name (CPI-C)

Artikel
10/14/2023

Der Extract_Partner_LU_Name-Aufruf (Funktionsname cmepln) gibt den Partner-LU-Namen und die Länge des Partner-LU-Namens für eine angegebene Unterhaltung zurück. Dies kann ein Aliasname von bis zu acht Bytes oder ein vollqualifizierter Netzwerkname mit bis zu 17 Bytes sein.

Syntax

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

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.

partner_LU_name
Zurückgegebener Parameter. Gibt die Variable an, die den Namen der Partner-LU enthält. (Das Programm muss einen Zeiger auf eine geeignete Variable bereitstellen.)

partner_LU_name_length
Zurückgegebener Parameter. Gibt die Länge des Partner-LU-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

Ein aufrufbares CPI-C-Transaktionsprogramm (TP) erhält den vollqualifizierten Netzwerknamen erst nach erfolgreichem Abschluss dieses Funktionsaufrufs. Ein aufrufbarer CPI-C TP kann den Aliasnamen mit diesem Aufruf nicht abrufen.

Freigeben über