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 |
|---|---|
|
El registro se realizó correctamente. |
|
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 |