Set_Conversation_Security_Password (CPI-C)

  • Articolo

La chiamata Set_Conversation_Security_Password (nome funzione cmscsp) viene emessa dal programma chiamante per specificare la password necessaria per ottenere l'accesso al programma richiamato.

Sintassi

  
CM_ENTRY Set_Conversation_Security_Password(   
  unsigned char FAR *conversation_ID,    
  unsigned char FAR *security_password,    
  CM_INT32 FAR *security_password_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_password
Parametro fornito. Specifica la password necessaria per ottenere l'accesso al programma partner. Questo parametro è una stringa di caratteri composta da un massimo di otto caratteri ASCII e fa distinzione tra maiuscole e minuscole. Deve corrispondere alla password per l'identificatore utente configurato per il programma partner.

I caratteri consentiti sono:

  • Lettere maiuscole e minuscole.

  • Numerali da 0 a 9.

  • Caratteri speciali, ad eccezione dello spazio.

    Se è necessario usare 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_password_length
    Parametro fornito. Specifica la lunghezza di security_password. L'intervallo è compreso tra 0 e 8.

    Se è necessario usare 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_password_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.

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 della password iniziale dalle informazioni sul lato specificate da Initialize_Conversation. Questa chiamata non può essere eseguita dopo l'emissione di Allocate .

Non viene rilevata una password non valida fino a quando la richiesta di allocazione, generata da Allocate, viene inviata all'unità logica del partner.An invalid password is not detected until the allocation request, generate by Allocate, is sent to the partner logical unit (LU). L'errore viene restituito al programma di richiamo in una chiamata successiva.

L'accesso automatico per le applicazioni CPI-C è supportato da Host Integration Server. Questa funzionalità richiede una configurazione specifica da parte dell'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, ma può essere qualsiasi piattaforma che supporti le API CPI-C di Host Integration Server.

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