Compartir a través de

Extract_Conversation_Security_Type (CPI-C)

  • Artículo

La llamada Extract_Conversation_Security_Type (nombre de función xcecst) devuelve el tipo de seguridad de una conversación especificada.

Sintaxis

  
CM_ENTRY Extract_Conversation_Security_Type(   
  unsigned char FAR *conversation_ID,          
    CM_INT32 FAR *conversation_security_type,    
    CM_INT32 FAR *return_code                    
);

Parámetros

conversation_ID
Parámetro proporcionado. Especifica el identificador de la conversación. El valor de este parámetro lo devolvió Initialize_Conversation o Accept_Conversation.

conversation_security_type
Parámetro devuelto. Especifica la información que requiere la unidad lógica de asociado (LU) para validar el acceso al programa invocado. Los valores posibles son:

CM_SECURITY_NONE
El programa invocado no usa ninguna seguridad de conversación.

CM_SECURITY_PROGRAM
El programa invocado usa la seguridad de la conversación y, por tanto, requiere un identificador de usuario y una contraseña.

CM_SECURITY_SAME
El programa invocado, invocado con un identificador de usuario y una contraseña válidos, a su vez invoca otro programa (como se muestra en Comunicación entre CSP). Por ejemplo, suponga que el programa A invoca el programa B con un identificador de usuario y una contraseña válidos, y el programa B a su vez invoca el programa C. Si el programa B especifica el valor CM_SECURITY_SAME, CPI-C envía la LU para el programa C, el identificador de usuario del programa A y un indicador ya comprobado. Este indicador indica al programa C que no requiera la contraseña (si el programa C está configurado para aceptar un indicador ya comprobado).

return_code
Código devuelto de esta llamada. Los códigos de retorno válidos se enumeran más adelante en este tema.

Códigos de retorno

CM_OK
Código de retorno principal; la llamada se ejecutó correctamente.

CM_PROGRAM_PARAMETER_CHECK
Código de retorno principal; el valor especificado por conversation_ID no es válido o la dirección de una variable no es válida.

Cambios de estado

La conversación puede estar en cualquier estado excepto RESET.

No hay ningún cambio de estado.