Freigeben über

Extract_Conversation_Security_Type (CPI-C)

  • Artikel

Der Extract_Conversation_Security_Type-Aufruf (Funktionsname xcecst) gibt den Sicherheitstyp für eine angegebene Konversation zurück.

Syntax

  
CM_ENTRY Extract_Conversation_Security_Type(   
  unsigned char FAR *conversation_ID,          
    CM_INT32 FAR *conversation_security_type,    
    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.

conversation_security_type
Zurückgegebener Parameter. Gibt die Informationen an, die die partner logical unit (LU) benötigt, um den Zugriff auf das aufgerufene Programm zu überprüfen. Mögliche Werte:

CM_SECURITY_NONE
Das aufgerufene Programm verwendet keine Konversationssicherheit.

CM_SECURITY_PROGRAM
Das aufgerufene Programm verwendet Unterhaltungssicherheit und erfordert daher eine Benutzer-ID und ein Kennwort.

CM_SECURITY_SAME
Das aufgerufene Programm, das mit einer gültigen Benutzer-ID und einem gültigen Kennwort aufgerufen wird, ruft wiederum ein anderes Programm auf (wie in Kommunikation zwischen TPs dargestellt). Angenommen, Programm A ruft Programm B mit einer gültigen Benutzer-ID und einem gültigen Kennwort auf, und Programm B wiederum ruft Programm C auf. Wenn Programm B den Wert CM_SECURITY_SAME angibt, sendet CPI-C die LU für Programm C, die Benutzer-ID aus Programm A und einen bereits verifizierten Indikator. Dieser Indikator weist Programm C an, das Kennwort nicht anzufordern (wenn Programm C so konfiguriert ist, dass es einen bereits verifizierten Indikator akzeptiert).

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, oder die Adresse einer Variablen ist ungültig.

Zustandsänderungen

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

Es gibt keine Zustandsänderung.