共用方式為

nmrWaitForProviderDeregisterComplete 函式 (netioddk.h)

  • 發行項

NmrWaitForProviderDeregisterComplete 函式會等候提供者模組的取消註冊完成。

語法

NTSTATUS NmrWaitForProviderDeregisterComplete(
  [in] HANDLE NmrProviderHandle
);

參數

[in] NmrProviderHandle

NMR 用來表示提供者模組註冊的句柄。 當提供者模組呼叫 NmrRegisterProvider 函式時，NMR 會將此句柄傳回給提供者模組。

傳回值

NmrWaitForProviderDeregisterComplete 函式會傳回下列其中一個 NTSTATUS 程序代碼：

傳回碼 Description
STATUS_SUCCESS
 NMR 已完成取消註冊提供者模組。
STATUS_INVALID_PARAMETER
 在呼叫 NmrDeregisterProvider 函式之前，提供者模塊稱為 NmrWaitForProviderDeregisterComplete 函式，或 NmrClientHandle 參數中指定的句柄不是有效的提供者句柄。
其他狀態代碼
 發生錯誤。

備註

提供者模組會呼叫 NmrWaitForProviderDeregisterComplete 函式，以等候提供者模組的取消註冊完成。 提供者模組只有在呼叫NmrDeregisterProviderProvider函式之後，才會呼叫NmrWaitForProviderDeregisterComplete 函式。

提供者模組通常會從其 Unload 函式呼叫 NmrWaitForProviderDeregisterComplete 函式，等到從 NMR 完全取消註冊，再從系統卸除提供者模組。 在取消註冊完成之前，提供者模組不得從其 Unload 函式的呼叫傳回。

注意 如果提供者模組使用 Windows 驅動程式架構，通常會呼叫 NmrWaitForProviderDeregisterComplete 函式來自其 EvtDriverUnload 事件回呼函式。 在此情況下，提供者模組不得從其 EvtDriverUnload 函式的呼叫傳回，直到取消註冊完成為止。
 

規格需求

需求 值
最低支援的用戶端 可在 Windows Vista 和更新版本的 Windows 作業系統中使用。
目標平台 桌面
標頭 netioddk.h (包含 Wsk.h)
程式庫 Netio.lib
IRQL < DISPATCH_LEVEL

另請參閱

NmrDeregisterProvider