Set_Conversation_Security_User_ID (CPI-C)

  • Articolo

La chiamata Set_Conversation_Security_User_ID (nome funzione cmscsu) viene rilasciata dal programma di chiamata per specificare l'identificatore utente necessario per ottenere l'accesso al programma richiamato.

Sintassi

  
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              
);

Parametri

conversation_ID
Parametro fornito. Specifica l'identificatore per la conversazione. Il valore di questo parametro è stato restituito da Initialize_Conversation.

security_user_ID
Parametro fornito. Specifica l'identificatore utente necessario per ottenere l'accesso al programma partner. Questo parametro è una stringa di caratteri fino a otto caratteri ASCII ed è distinzione tra maiuscole e minuscole.

I caratteri consentiti sono:

  • Lettere maiuscole e minuscole.

  • Numeri da 0 a 9.

  • Caratteri speciali, ad eccezione dello spazio.

    Se deve essere usata la funzionalità di accesso automatico CPI-C, questo parametro deve essere impostato sulla stringa MS$SAME. Per informazioni dettagliate, vedere la sezione Osservazioni più avanti in questo argomento.

    security_user_ID_length
    Parametro fornito. Specifica la lunghezza di security_user_ID. L'intervallo è compreso tra 0 e 8.

    Se deve essere usata la funzionalità di accesso automatico CPI-C, questo parametro deve essere impostato su 7. Per informazioni dettagliate, vedere la sezione Osservazioni più avanti in questo argomento.

    return_code
    Codice restituito da questa chiamata. I codici restituiti validi sono elencati più avanti in questo argomento.

Codici restituiti

CM_OK
Codice restituito primario; la chiamata eseguita correttamente.

CM_PROGRAM_PARAMETER_CHECK
Codice restituito primario; si è verificato uno dei seguenti:

  • Il valore specificato da conversation_ID non è valido.

  • Il valore specificato da security_user_ID_length non è compreso nell'intervallo.

    CM_PROGRAM_STATE_CHECK
    Codice restituito primario; si è verificato uno dei seguenti:

  • La conversazione non è in stato INITIALIZE.

  • Il tipo di sicurezza delle conversazioni non è impostato su CM_SECURITY_PROGRAM.

    CM_PRODUCT_SPECIFIC_ERROR
    Codice restituito primario; si è verificato un errore specifico del prodotto ed è stato registrato nel log degli errori dei prodotti.

Modifiche di stato

La conversazione deve essere in stato INITIALIZE.

Non esiste alcuna modifica dello stato.

Commenti

Questa chiamata ha effetto sulla conversazione solo se il tipo di sicurezza della conversazione è CM_SECURITY_PROGRAM o CM_SECURITY_SAME. Esegue l'override dell'identificatore utente iniziale dalle informazioni lato specificate da Initialize_Conversation. Questa chiamata non può essere emessa dopo l'emissione dell'allocazione .

Un identificatore utente non valido non viene rilevato finché la richiesta di allocazione, generata da Allocate, viene inviata all'unità logica partner (LU). L'errore viene restituito al programma di chiamata in una chiamata successiva.

L'accesso automatico per le applicazioni CPI-C è supportato da Host Integration Server. Questa funzionalità richiede una configurazione specifica dall'amministratore di rete. L'applicazione CPI-C deve essere richiamata sul lato LAN da un client di SNA Server. Il client deve essere connesso a un dominio di Microsoft Windows Server, ma può essere qualsiasi piattaforma che supporta le API CPI-C di SNA Server.

L'applicazione client viene codificata per usare la sicurezza a livello di programma, con un nome utente CPI-C speciale con codice rigido MS$SAME e password MS$SAME. Quando questa allocazione sessione passa dal client al server SNA, il server SNA cerca l'account host e la password corrispondenti all'account di Windows Server in cui il client è connesso e sostituisce le informazioni sull'account host nel messaggio di collegamento appC inviato all'host.