Función Netbios (nb30.h)

[Netbios no se admite en Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo]

La función Netbios interpreta y ejecuta el bloque de control de red (NCB) especificado.

La función Netbios se proporciona principalmente para las aplicaciones escritas para la interfaz NetBIOS y deben migrarse a Windows. Las aplicaciones que no requieren compatibilidad con NetBIOS deben usar otras interfaces, como Windows Sockets, mailslots, canalizaciones con nombre, RPC o COM distribuidas para realizar tareas similares a las admitidas por NetBIOS. Estas otras interfaces son más flexibles y portátiles.

Sintaxis

UCHAR Netbios(
  PNCB pncb
);

Parámetros

pncb

Puntero a una estructura NCB que describe el bloque de control de red.

Valor devuelto

Para las solicitudes sincrónicas, el valor devuelto es el código devuelto en la estructura NCB . Ese valor también se devuelve en el miembro ncb_retcode de la estructura NCB .

En el caso de las solicitudes asincrónicas, hay las siguientes posibilidades:

• Si el comando asincrónico ya se ha completado cuando Netbios vuelve a su llamador, el valor devuelto es el código devuelto de la estructura NCB, como si fuera una estructura NCB sincrónica.
• Si el comando asincrónico sigue pendiente cuando Netbios vuelve a su llamador, el valor devuelto es cero.

Si la dirección especificada por el parámetro pncb no es válida, el valor devuelto es NRC_BADNCB.

Si la longitud del búfer especificada en el miembro ncb_length de la estructura NCB es incorrecta o si el búfer especificado por el miembro ncb_retcode está protegido contra las operaciones de escritura, el valor devuelto se NRC_BUFLEN.

Comentarios

Cuando finaliza un bloque de control de red asincrónico y el miembro ncb_post es distinto de cero, se llama a la rutina especificada en ncb_post con un único parámetro. Este parámetro contiene un puntero a una estructura NCB , el bloque de control de red.

La estructura NCB contiene un identificador de un evento (el miembro ncb_event ). El sistema establece el evento en el estado no asignado cuando se acepta un comando NetBIOS asincrónico y establece el evento en el estado señalado cuando se completa el comando NetBIOS asincrónico. Solo se deben usar eventos de restablecimiento manual para la sincronización. Un evento especificado no debe estar asociado a más de un comando NetBIOS asincrónico activo.

El uso de ncb_event para enviar solicitudes asincrónicas requiere menos recursos del sistema que el uso de ncb_post. Además, cuando ncb_event es distinto de cero, la solicitud pendiente se cancela si el subproceso finaliza antes de procesar la solicitud. Esto no es cierto para las solicitudes enviadas mediante ncb_post.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	nb30.h
Library	Netapi32.lib
Archivo DLL	Netapi32.dll

Consulte también

NCB