wskRegister 函式 (wsk.h)
WskRegister 函式會註冊 WSK 應用程式,因為應用程式的 WSK 用戶端網路程式設計介面 (NPI) 。
語法
NTSTATUS WskRegister(
[in] PWSK_CLIENT_NPI WskClientNpi,
[out] PWSK_REGISTRATION WskRegistration
);
參數
[in] WskClientNpi
WSK 應用程式所實作之用戶端 NPI 的指標。
[out] WskRegistration
識別 WSK 應用程式註冊實例的記憶體位置指標。 此記憶體位置將會由 WskRegister 呼叫初始化,並供其他 WSK 註冊函式使用。 WSK 應用程式不應該直接變更此記憶體位置的內容。
傳回值
WskRegister 會傳回下列其中一個 NTSTATUS 代碼:
傳回碼 | Description |
---|---|
|
註冊成功。 |
|
註冊失敗。 |
備註
WSK 用戶端物件可以多次呼叫此函式,但每個呼叫都必須使用不同的 WskRegistration 參數,才能建立多個註冊實例。
對於每個傳回成功碼的 WskRegister 呼叫,都必須有一個對應的 WskDeregister 呼叫,該呼叫會使用相同的 WskRegistration 參數傳遞至 WskRegister。
WskRegistration 所指向的記憶體區塊必須保持配置, (不得釋放或離開範圍) 只要其他 WSK 註冊函式有未完成的呼叫即可。
使用 WskRegister 和 WskDeregister 函式是註冊和取消註冊 WSK 應用程式的慣用方法。 網路模組註冊機構仍可供相容性使用。
如需將 WSK 應用程式附加至 WSK 子系統的詳細資訊,請參閱 註冊 Winsock 核心應用程式。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
目標平台 | Universal |
標頭 | wsk.h (包含 Wsk.h) |
程式庫 | Netio.lib |
IRQL | PASSIVE_LEVEL |