Compartir a través de

Set_Conversation_Security_User_ID (CPI-C)

  • Artículo

El programa de invocación emite el Set_Conversation_Security_User_ID llamada (nombre de función cmscsu) para especificar el identificador de usuario necesario para obtener acceso al programa invocado.

Sintaxis

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

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_user_ID
Parámetro proporcionado. Especifica el identificador de usuario necesario 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.

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_user_ID_length
    Parámetro proporcionado. Especifica la longitud de security_user_ID. 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_user_ID_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.

    CM_PRODUCT_SPECIFIC_ERROR
    Código de retorno principal; se produjo un error específico del producto y se ha registrado en el registro de errores de productos.

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. Reemplaza el identificador de usuario 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 un identificador de usuario no válido 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 del servidor SNA. El cliente debe iniciar sesión en un dominio de Microsoft Windows Server, pero puede ser cualquier plataforma que admita las API CPI-C de SNA 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 Server con la que el cliente ha iniciado sesión y sustituye la información de la cuenta de host en el mensaje de asociación de APPC que envía al host.