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
STATUS_SUCCESS	註冊成功。
其他狀態代碼	註冊失敗。

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