sbpuinit
La función sbpuinit inicializa DL-BASE.
Sintaxis
USHORT sbpuinit(
HANDLE *sema4ptr,
USHORT proctype,
USHORT servtype,
UCHAR *uname
);
Parámetros
sema4ptr
Semáforo, creado por el módulo de acceso dinámico (DMOD), borrado por DMOD cuando hay un mensaje disponible. Esta dirección es para uso interno de Host Integration Server. Posteriormente, la aplicación no debe intentar hacer referencia a la dirección.
proctype
Tipo de proceso: CLIENT–2.
servtype
Tipo de servicio/cliente: CES3270–2.
uname
Puntero a un búfer de caracteres de longitud al menos 21 caracteres; el nombre de usuario de LAN Manager u otro nombre de identificación adecuado para el sistema operativo de red, se devuelve a la aplicación en este búfer. La aplicación no necesita usar este parámetro, pero puede usarla para mostrar o registrar.
Valor devuelto
NO_ERROR
Inicialización correcta.
Cualquier otro valor devuelto indica que se produjo un error en la inicialización. Normalmente, se trata de un código de retorno del sistema operativo. También se usan los valores siguientes:
DMLTABF (555)
La tabla L está llena.
DMMNWGI (562)
No se pudo obtener información del sistema operativo de red.
DMDSTFL (563)
La tabla de servicio está llena.
DMMPIPF (567)
No se pudo crear una canalización con nombre.
DMCOMNM (582)
No hay ningún nombre registrado para esta aplicación.
DMCOMDUP (596)
Ya se está ejecutando un servicio con el mismo nombre.
DMNOTLOG (598)
El usuario no ha iniciado sesión en el sistema operativo de red.
DMCFGOPN (616)
No se pudo abrir el archivo de configuración.
DMCFGREAD (618)
No se pudo leer desde el archivo de configuración.
DMNONAP (625)
El Programa de acceso a la red (NAP) no se inicia.
DMMAXAPP (953)
Solo Windows: se superó el número máximo de aplicaciones simultáneas.
Comentarios
Siempre se debe llamar al punto de entrada sbpuinit antes de cualquier otro punto de entrada DL-BASE o DMOD excepto SNAGetVersion. Para 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 se admita sbpuinit , pero no se recomienda este orden).