Función WskRegister (wsk.h)
La función WskRegister registra una aplicación WSK, dado el cliente WSK de la aplicación interfaz de programación de red (NPI).
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. Esta ubicación de memoria se inicializará mediante la llamada de WskRegister y la usarán las otras funciones de registro de WSK de . 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. |
Observaciones
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 un WskDeregister llamada que usa el mismo parámetro WskRegistration que se pasó a WskRegister.
El bloque de memoria al que apunta WskRegistration debe mantenerse asignado (no debe liberarse ni salir del ámbito) siempre que haya llamadas pendientes a otras funciones de registro de WSK .
El uso de las funciones WskRegi ster y WskDeregister es el método preferido para registrar y anular el registro de aplicaciones WSK. El registrador de módulos de red de sigue estando disponible para su compatibilidad.
Para obtener más información sobre cómo adjuntar una aplicación WSK al subsistema WSK, consulte Registro de una aplicación de kernel winsock.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows Vista y versiones posteriores de los sistemas operativos Windows. |
| de la plataforma de destino de | Universal |
| encabezado de | wsk.h (incluya Wsk.h) |
| biblioteca de | Netio.lib |
| irQL | PASSIVE_LEVEL |