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

  • Статья

Функция WskRegister регистрирует приложение 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:

Код возврата Описание
STATUS_SUCCESS
 Регистрация выполнена успешно.
Другие коды состояния
 Сбой регистрации.

Комментарии

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

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

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

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

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

Требования

Требование Значение
Минимальная версия клиента Доступно в Windows Vista и более поздних версиях операционных систем Windows.
Целевая платформа Универсальное
Верхняя часть wsk.h (включая Wsk.h)
Библиотека Netio.lib
IRQL PASSIVE_LEVEL

См. также раздел

WSK_CLIENT_NPI

WSK_REGISTRATION

WskDeregister