Extract_Conversation_Security_User_ID (CPI-C)

Der Extract_Conversation_Security_User_ID Aufruf (Funktionsname cmecsu) gibt den Benutzerbezeichner zurück, der in einer angegebenen Unterhaltung verwendet wird.

Syntax

  
CM_ENTRY Extract_Conversation_Security_User_ID(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *security_user_ID,    
  CM_INT32 FAR *security_user_ID_length,    
  CM_INT32 FAR *return_code              
);  

Die 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.

security_user_ID
Zurückgegebener Parameter. Gibt den Benutzerbezeichner an, der zum Einrichten der Unterhaltung verwendet wurde.

security_user_ID_length
Zurückgegebener Parameter. Gibt die Länge von security_user_ID 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.

Statusänderungen

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

Es gibt keine Zustandsänderung.

Bemerkungen

Der security_user_ID Wert ist nicht mit Leerzeichen aufgefüllt. Es ist nur bis zu security_user_ID_length sinnvoll.