Función WskRegister (wsk.h)

La función WskRegister registra una aplicación WSK, dada la interfaz de programación de red (NPI) del cliente WSK de la aplicación.

Sintaxis

NTSTATUS WskRegister(
  [in]  PWSK_CLIENT_NPI   WskClientNpi,
  [out] PWSK_REGISTRATION WskRegistration
);

Parámetros

[in] WskClientNpi

Puntero al NPI de cliente implementado por la aplicación WSK.

[out] WskRegistration

Puntero a una ubicación de memoria que identifica la instancia de registro de una aplicación WSK. La llamada a WskRegister inicializará esta ubicación de memoria y la usarán las demás funciones de registro de WSK. La aplicación WSK nunca debe cambiar el contenido de esta ubicación de memoria directamente.

Valor devuelto

WskRegister devuelve uno de los siguientes códigos NTSTATUS:

Código devuelto Descripción
STATUS_SUCCESS
El registro se realizó correctamente.
Otros códigos de estado
Error en el registro.

Comentarios

Un objeto de cliente WSK puede llamar a esta función varias veces, pero se debe usar un parámetro WskRegistration diferente para cada llamada con el fin de crear varias instancias de registro.

Para cada llamada a WskRegister que devuelve un código correcto, debe haber exactamente una llamada WskDeregister correspondiente que use el mismo parámetro WskRegistration que se pasó a WskRegister.

El bloque de memoria al que apunta WskRegistration debe mantenerse asignado (no debe liberarse o salir del ámbito) siempre que haya llamadas pendientes a otras funciones de registro de WSK.

El uso de las funciones WskRegister y WskDeregister es el método preferido para registrar y anular el registro de aplicaciones WSK. El registrador de módulos de red sigue estando disponible para la compatibilidad.

Para obtener más información sobre cómo adjuntar una aplicación WSK al subsistema WSK, consulte Registro de una aplicación kernel de Winsock.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows.
Plataforma de destino Universal
Encabezado wsk.h (incluya Wsk.h)
Library Netio.lib
IRQL PASSIVE_LEVEL

Consulte también

WSK_CLIENT_NPI

WSK_REGISTRATION

WskDeregister