Функция 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:
Код возврата | Описание |
---|---|
|
Регистрация выполнена успешно. |
|
Сбой регистрации. |
Комментарии
Клиентский объект 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 |