sepdcrec

La función sepdcrec obtiene información de configuración. La aplicación llama a esta función para obtener la información de configuración 3270 para el nombre con el que el usuario inició sesión en el sistema operativo de red. La llamada también registra este nombre de usuario en la tabla de servicio.

Sintaxis

  
USHORT sepdcrec(   
UCHAR *pBuffer,  
USHORT length,  
USHORT *numbytes  
);  

Parámetros

pBuffer
Puntero a un búfer proporcionado por la aplicación, en el que se devuelve información de configuración.

length
Tamaño del búfer proporcionado.

entumecimientos
Usado por Host Integration Server para devolver el número de bytes de información devuelta en el búfer.

Valor devuelto

NO_ERROR (0)
Aceptar.

NOCSSRVR (1)
No hay ningún servidor de archivos de configuración disponible.

NODGNREC (2)
No se encontró ningún registro de diagnóstico en el archivo de configuración.

NOUSRREC (3)
No se encontró ningún registro de usuario en el archivo de configuración de este usuario.

BUF2SMAL (4)
El búfer proporcionado era demasiado pequeño.

NONOS (5)
No se inicia el sistema operativo de red.

NOTLOGON (6)
El usuario no ha iniciado sesión en el sistema operativo de red.

LECTOR (7)
No se pudo leer desde el archivo de configuración.

NONAP (8)
El Programa de acceso a la red (NAP) no se inicia.

MAXAPP (9)
Solo Windows: se superó el número máximo de aplicaciones simultáneas.

ERROR_SERVER (14)
Error en el extremo del servidor de la llamada a procedimiento remoto (RPC).

ERROR_LOCAL_FAILURE (15)
Error en el extremo local de rpc.

Comentarios

Siempre se debe llamar a la función sbpuinit antes de cualquier otro punto de entrada dl-BASE o módulo de acceso dinámico (DMOD), excepto SNAGetVersion. En el caso de los nuevos emuladores, se debe llamar a sepdcrec después de sbpuinit. (Debido al orden de las llamadas usadas en emuladores anteriores, se sigue admitiendo una llamada a sepdcrec antes de que sbpuinit siga siendo compatible, pero no se recomienda este orden).

Si la devolución es correcta, el búfer contiene punteros al registro de usuario 3270 adecuado y al registro de diagnóstico, seguido de los propios registros. Tiene el formato siguiente:

TECWRKUS *pUserRecord,   
TEDIAGNS *pDiagRecord   
);  

(UserRecord: longitud variable)

(DiagRecord)

Se debe tener acceso a los dos registros mediante los punteros proporcionados.

Consulte Información de configuración para obtener más información sobre el formato de estos registros y sobre cómo la aplicación usa la información del archivo de configuración.

Si no hay ningún registro de usuario 3270 para este usuario en el archivo de configuración, o si no se encuentra ningún registro de diagnóstico en el archivo de configuración (un error interno), la aplicación debe finalizar y no permitir que el usuario use la emulación 3270. Los mensajes de registro de errores de Host Integration Server COM0438 y COM0437 se pueden usar para notificar estos errores.

Si el búfer proporcionado es demasiado pequeño para la información devuelta, el contenido del búfer no está definido y no debe examinarse, pero el parámetrotumes contendrá el número total de bytes de información disponible (es decir, el tamaño de los dos punteros más los dos registros de configuración). La aplicación debe reintentar con un búfer de al menos este tamaño.