Set_Conversation_Security_User_ID - UTM-Benutzerkennung setzen

Die Funktion Set_Conversation_Security_User_ID (CMSCSU) setzt die Werte für die Characteristics security_user_ID und security_user_ID_length der Conversation.
Unter der security_user_ID versteht man eine Benutzerkennung einer UTM-Anwendung.

Ein Programm kann eine Benutzerkennung nur dann angeben, wenn die Characteristic security_type auf CM_SECURITY_PROGRAM gesetzt ist.

Der Aufruf darf nach Allocate() nicht mehr ausgeführt werden.

Diese Funktion gehört zu den Advanced Functions.

Syntax

CMSCSU (conversation_ID, security_user_ID, security_user_ID_length, return_code)

Parameter

--> conversation_ID	Identifikation der Conversation
--> security_user_ID	Benutzerkennung, die zum Einrichten der Conversation benutzt wird. Die UTM-Partner-Anwendung verwendet die Benutzerkennung und ggf. das Passwort, um die Zugangsberechtigung zu überprüfen. Zusätzlich kann die Partner-Anwendung die Benutzerkennung zur Protokollierung oder zur Abrechnung verwenden.
--> security_user_ID_length	Länge der in security_user_ID angegebenen Benutzerkennung in Byte. Minimum: 0, Maximum: 8 Wird hier 0 angegeben, obwohl security_type im Aufruf Set_Conversation_Security_Type auf den Wert CM_SECURITY_PROGRAM gesetzt wurde, dann kommt keine Verbindung zu openUTM zustande (Fehler beim Aufruf Allocate).
<-- return_code	Ergebnis des Funktionsaufrufs

Ergebnis ( return_code )

CM_OK

Aufruf ok

CM_PROGRAM_STATE_CHECK

Die Conversation ist nicht im Zustand "Initialize" oder security_type ist nicht auf CM_SECURITY_PROGRAM gesetzt.

CM_PROGRAM_PARAMETER_CHECK

Der Wert in conversation_ID ist ungültig oder der Wert in security_user_ID_length ist kleiner als 0 oder größer als 8.

CM_PRODUCT_SPECIFIC_ERROR

Die UPIC-Instanz konnte nicht gefunden werden.

Falls das Ergebnis nicht CM_OK ist, bleiben die Characteristics security_user_ID und security_user_ID_length unverändert.

Zustandsänderung

Keine Zustandsänderung.

Hinweis

• Eine ungültige Benutzerkennung wird bei diesem Aufruf nicht erkannt. Die Partner-Anwendung überprüft die Benutzerkennung nach dem Einrichten der Conversation auf Gültigkeit. Bei ungültiger Benutzerkennung lehnt die UTM-Anwnedung die Conversation ab.

• Das Programm erkennt eine ungültige Benutzerkennung oder ein fehlerhaftes Passwort durch den Returncode CM_SECURITY_NOT_VALID. Dieser wird nach einem dem Allocate() folgendem Receive-Aufruf zurückgegeben.

• Wird im Aufruf Set_Conversation_Security_Type() der Parameter security_type auf CM_SECURITY_NONE gesetzt, dann ist der Aufruf Set_Conversation_Security_User_ID() nicht erlaubt.

Verhalten im Fehlerfall

CM_PROGRAM_PARAMETER_CHECK

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_User_ID

CM_ENTRY   Set_Conversation_Security_User_ID (
                       unsigned char  CM_PTR  conversation_ID,
                       unsigned char  CM_PTR  security_user_ID,
                       CM_INT32       CM_PTR  security_user_ID_length,
                       CM_RETURN_CODE CM_PTR  return_code )