Функция WskRegister (wsk.h)

Функция WskRegister регистрирует приложение WSK, учитывая клиента WSK приложениясетевой интерфейс программирования (NPI).

Синтаксис

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

Параметры

[in] WskClientNpi

Указатель на NPI клиента, реализованный приложением WSK.

[out] WskRegistration

Указатель на расположение памяти, определяющее экземпляр регистрации приложения WSK. Это расположение памяти будет инициализировано вызовом WskRegister и будет использоваться другими функциями регистрации WSK. Приложение WSK никогда не должно изменять содержимое этого расположения памяти напрямую.

Возвращаемое значение

WskRegister возвращает один из следующих кодов NTSTATUS:

Замечания

Клиентский объект WSK может вызывать эту функцию несколько раз, но для создания нескольких экземпляров регистрации необходимо использовать другой параметр WskRegistration.

Для каждого вызова WskRegister, возвращающего код успешности, должен быть именно один соответствующий вызов WskDeregister, использующий тот же параметр WskRegistration, переданный WskRegister.

Блок памяти, на который указывает WskRegistration, должен быть выделен (не должен быть освобожден или выйти из области), если существуют неустанные вызовы других функций регистрации WSK .

Использование WskRegister и функций WskDeregister является предпочтительным способом регистрации и отмены регистрации приложений WSK. регистратора сетевых модулей остается доступным для обеспечения совместимости.

Дополнительные сведения о присоединении приложения WSK к подсистеме WSK см. в регистрации приложения ядра Winsock.

Требования

См. также

WSK_CLIENT_NPI

WSK_REGISTRATION

WskDeregister