Compartir a través de

Set_Conversation_Security_Password (CPI-C)

  • Artículo

El programa de invocación emite la llamada Set_Conversation_Security_Password (nombre de función cmscsp) para especificar la contraseña necesaria para obtener acceso al programa invocado.

Sintaxis

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

Parámetros

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

security_password
Parámetro proporcionado. Especifica la contraseña necesaria para obtener acceso al programa asociado. Este parámetro es una cadena de caracteres de hasta ocho caracteres ASCII y distingue mayúsculas de minúsculas. Debe coincidir con la contraseña del identificador de usuario configurado para el programa asociado.

Los caracteres permitidos son:

  • Mayúsculas y minúsculas.

  • Números de 0 a 9.

  • Caracteres especiales, excepto el espacio.

    Si se va a usar la característica de inicio de sesión automático CPI-C, este parámetro debe establecerse en la cadena MS$SAME. Para obtener más información, consulte la sección Comentarios más adelante en este tema.

    security_password_length
    Parámetro proporcionado. Especifica la longitud de security_password. El intervalo es de 0 a 8.

    Si se va a usar la característica de inicio de sesión automático CPI-C, este parámetro debe establecerse en 7. Para obtener más información, consulte la sección Comentarios más adelante en este tema.

    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; se produjo una de las siguientes acciones:

  • El valor especificado por conversation_ID no es válido.

  • El valor especificado por security_password_length está fuera del intervalo.

    CM_PROGRAM_STATE_CHECK
    Código de retorno principal; se produjo una de las siguientes acciones:

  • La conversación no está en estado INITIALIZE.

  • El tipo de seguridad conversations no está establecido en CM_SECURITY_PROGRAM.

Cambios de estado

La conversación debe estar en estado INITIALIZE.

No hay ningún cambio de estado.

Comentarios

Esta llamada tiene un efecto en la conversación solo si el tipo de seguridad de la conversación es CM_SECURITY_PROGRAM o CM_SECURITY_SAME. Invalida la contraseña inicial de la información lateral especificada por Initialize_Conversation. Esta llamada no se puede emitir después de que se haya emitido Allocate .

No se detecta una contraseña no válida hasta que la solicitud de asignación, generada por Allocate, se envía a la unidad lógica (LU) del asociado. El error se devuelve al programa de invocación en una llamada posterior.

El inicio de sesión automático para aplicaciones CPI-C es compatible con Host Integration Server. Esta característica requiere una configuración específica por parte del administrador de red: la aplicación CPI-C debe invocarse en el lado LAN desde un cliente de SNA Server. El cliente debe iniciar sesión en un dominio de Microsoft Windows, pero puede ser cualquier plataforma que admita las API CPI-C de Host Integration Server.

La aplicación cliente se codifica para usar la seguridad de nivel de programa, con un nombre de usuario CPI-C codificado de forma rígida especial MS$SAME y la contraseña MS$SAME. Cuando esta asignación de sesión fluye desde el cliente al servidor SNA, el servidor SNA busca la cuenta de host y la contraseña correspondientes a la cuenta de Windows con la que el cliente ha iniciado sesión y sustituye la información de la cuenta host en el mensaje de asociación de APPC que envía al host.