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 程式代碼：

傳回碼	描述
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