Set_Conversation_Security_Type - Security-Typ setzen

Die Funktion Set_Conversation_Security_Type (CMSCST) setzt den Wert für die Characteristic security_type der Conversation.

Der Aufruf überschreibt den Wert, der beim Initialize_Conversation-Aufruf zugewiesen wurde und darf nach Allocate nicht mehr ausgeführt werden.

Diese Funktion gehört zu den Advanced Functions.

Syntax

CMSCST (conversation_ID, security_type, return_code)

Parameter

--> conversation_ID	Identifikation der Conversation
--> security_type	gibt den Typ von Zugangsinformationen an, die beim Einrichten der Conversation an die Partner-Anwendung gesendet werden. Mit Hilfe dieser Informationen überprüft die Partner-Anwendung die Zugangsberechtigung. Für security_type können folgende Werte gesetzt werden: CM_SECURITY_NONE Es werden keine Zugangsinformationen an die Partner-Anwendung übertragen. CM_SECURITY_PROGRAM Als Zugangsinformationen werden die Werte der Characteristics security_user_ID und security_password verwendet. D.h. die Zugangsinformationen bestehen entweder aus einer UTM-Benutzerkennung oder aus einer UTM-Benutzerkennung und einem Passwort.
<-- return_code	Ergebnis des Funktionsaufrufs

Ergebnis (return_code)

CM_OK

Aufruf ok

CM_PROGRAM_STATE_CHECK

Die Conversation ist nicht im Zustand "Initialize".

CM_PROGRAM_PARAMETER_CHECK

Der Wert in conversation_ID ist ungültig oder der Wert in security_type ist undefiniert.

CM_PARM_VALUE_NOT_SUPPORTED

In security_type wurde ein von CPI-C nicht unterstützter Wert eingetragen.

CM_PRODUCT_SPECIFIC_ERROR

Die UPIC-Instanz konnte nicht gefunden werden.

Falls das Ergebnis nicht CM_OK ist, bleibt die Characteristic security_type unverändert.

Zustandsänderung

Keine Zustandsänderung.

Hinweis

• Wird in security_type der Wert CM_SECURITY_PROGRAM eingetragen, dann müssen Benutzerkennung und ggf. Passwort gesetzt werden mit den Aufrufen Set_Conversation_Security_User_ID und Set_Conversation_Security_Password.

• Wenn für die Zugangsprüfung nur die Benutzerkennung benötigt wird, ist der Aufruf Set_Conversation_Security_Password nicht notwendig.

Verhalten im Fehlerfall

CM_PROGRAM_PARAMETER_CHECK

Programm ändern.

CM_PARM_VALUE_NOT_SUPPORTED

Programm ändern.

CM_PRODUCT_SPECIFIC_ERROR

Das Betriebssystem kann nicht genügend Speicherplatz für interne Puffer bereitstellen. Überprüfen Sie Ihr Programm auf zu hohe Speicherplatzanforderung und starten Sie ggf. Ihr System neu.

Funktionsdeklaration: Set_Conversation_Security_Type

CM_ENTRY Set_Conversation_Security_Type (
          unsigned char                  CM_PTR  conversation_ID,
          CM_CONVERSATION_SECURITY_TYPE  CM_PTR   conversation_security_type,
          CM_RETURN_CODE                 CM_PTR  return_code )