Set_Conversation_Security_User_ID (CPI-C)

Der Set_Conversation_Security_User_ID Aufruf (Funktionsname cmscsu) wird vom aufrufenden Programm ausgegeben, um den benutzerbezeichner anzugeben, der erforderlich ist, um Zugriff auf das aufgerufene Programm zu erhalten.

Syntax

  
CM_ENTRY Set_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 zurückgegeben.

security_user_ID
Angegebener Parameter. Gibt die für den Zugriff auf das Partnerprogramm erforderliche Benutzer-ID an. Bei diesem Parameter handelt es sich um eine Zeichenfolge mit bis zu acht ASCII-Zeichen und bei Groß-/Kleinschreibung wird die Groß-/Kleinschreibung beachtet.

Die zulässigen Zeichen sind:

• Groß- und Kleinbuchstaben.

• Ziffern von 0 bis 9.

• Sonderzeichen mit Ausnahme des Leerzeichens.

  Wenn das feature CPI-C automatische Anmeldung verwendet werden soll, muss dieser Parameter auf die MS$SAME-Zeichenfolge festgelegt werden. Ausführliche Informationen finden Sie im Abschnitt "Hinweise" weiter unten in diesem Thema.

  security_user_ID_length
  Angegebener Parameter. Gibt die Länge von security_user_ID an. Der Bereich liegt zwischen 0 und 8.

  Wenn das feature für die automatische Anmeldung CPI-C verwendet werden soll, muss dieser Parameter auf 7 festgelegt werden. Ausführliche Informationen finden Sie im Abschnitt "Hinweise" weiter unten in diesem Thema.

  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; einer der folgenden Ereignisse:

• Der durch conversation_ID angegebene Wert ist ungültig.

• Der durch security_user_ID_length angegebene Wert liegt außerhalb des zulässigen Bereichs.

  CM_PROGRAM_STATE_CHECK
  Primärer Rückgabecode; einer der folgenden Ereignisse:

• Die Unterhaltung befindet sich nicht im INITIALIZE-Zustand.

• Der Sicherheitstyp "Unterhaltungen" ist nicht auf CM_SECURITY_PROGRAM festgelegt.

  CM_PRODUCT_SPECIFIC_ERROR
  Primärer Rückgabecode; Ein produktspezifischer Fehler ist aufgetreten und wurde im Fehlerprotokoll der Produkte protokolliert.

Statusänderungen

Die Unterhaltung muss sich im INITIALIZE-Zustand befinden.

Es gibt keine Zustandsänderung.

Bemerkungen

Dieser Anruf wirkt sich nur auf die Unterhaltung aus, wenn der Unterhaltungssicherheitstyp CM_SECURITY_PROGRAM oder CM_SECURITY_SAME ist. Er überschreibt die anfängliche Benutzer-ID von den durch Initialize_Conversation angegebenen Seiteninformationen. Dieser Aufruf kann nicht ausgegeben werden, nachdem "Zuweisung " ausgegeben wurde.

Ein ungültiger Benutzerbezeichner wird erst erkannt, wenn die zuordnungsanforderung, die von "Allocate" generiert wird, an die logische Partnereinheit (LU) gesendet wird. Der Fehler wird bei einem nachfolgenden Aufruf an das aufrufende Programm zurückgegeben.

Die automatische Anmeldung für CPI-C Anwendungen wird vom Hostintegrationsserver unterstützt. Für dieses Feature ist eine bestimmte Konfiguration durch den Netzwerkadministrator erforderlich. Die CPI-C-Anwendung muss auf der LAN-Seite von einem Client von SNA Server aufgerufen werden. Der Client muss bei einer Microsoft Windows Server-Domäne angemeldet sein, kann jedoch eine beliebige Plattform sein, die SNA Server CPI-C-APIs unterstützt.

Die Clientanwendung ist codiert, um die Sicherheit auf Programmebene mit einem speziell hartcodierten CPI-C Benutzernamen MS$SAME und kennwort MS$SAME zu verwenden. Wenn diese Sitzungszuweisung von Client zu SNA Server fließt, sucht der SNA-Server das Hostkonto und das Kennwort entsprechend dem Windows Server-Konto, unter dem der Client angemeldet ist, und ersetzt die Hostkontoinformationen in die APPC-Anfügen-Nachricht, die er an den Host sendet.