Condividi tramite

Extract_Conversation_Security_Type (CPI-C)

  • Articolo

La chiamata Extract_Conversation_Security_Type (nome funzione xcecst) restituisce il tipo di sicurezza per una conversazione specificata.

Sintassi

  
CM_ENTRY Extract_Conversation_Security_Type(   
  unsigned char FAR *conversation_ID,          
    CM_INT32 FAR *conversation_security_type,    
    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 o Accept_Conversation.

conversation_security_type
Parametro restituito. Specifica le informazioni richieste dall'unità logica partner (LU) per convalidare l'accesso al programma richiamato. I valori possibili sono:

CM_SECURITY_NONE
Il programma richiamato non usa alcuna sicurezza della conversazione.

CM_SECURITY_PROGRAM
Il programma richiamato usa la sicurezza della conversazione e quindi richiede un identificatore utente e una password.

CM_SECURITY_SAME
Il programma richiamato, richiamato con un identificatore utente e una password validi, richiama a sua volta un altro programma (come illustrato in Comunicazione tra TPS). Si supponga, ad esempio, che il programma A richiami il programma B con un identificatore utente e una password validi e che il programma B richiami a sua volta il programma C. Se il programma B specifica il valore CM_SECURITY_SAME, CPI-C invia l'lu per il programma C, l'identificatore utente dal programma A e un indicatore già verificato. Questo indicatore indica al programma C di non richiedere la password (se il programma C è configurato per accettare un indicatore già verificato).

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; il valore specificato da conversation_ID non è valido oppure l'indirizzo di una variabile non è valido.

Modifiche di stato

La conversazione può trovarsi in qualsiasi stato, ad eccezione di RESET.

Non esiste alcuna modifica dello stato.