共用方式為

SetNtmsDeviceChangeDetection 函式 (ntmsapi.h)

  • 發行項

[從 Windows 7 和 Windows Server 2008 R2 起，已不再提供卸除式儲存管理員 。]

SetNtmsDeviceChangeDetection 函式會設定一或多個目標裝置以進行變更偵測。

語法

DWORD SetNtmsDeviceChangeDetection(
  [in] HANDLE      hSession,
  [in] HANDLE      DetectHandle,
  [in] LPNTMS_GUID lpRequestId,
  [in] DWORD       dwType,
  [in] DWORD       dwCount
);

參數

[in] hSession

OpenNtmsSession 函式所傳回之會話的句柄。

[in] DetectHandle

從 BeginNtmsDeviceChangeDetection 或 NULL 進行單一輪詢的裝置變更偵測句柄。

[in] lpRequestId

目標裝置的物件識別碼。 此參數可以是一或多個連結庫、媒體類型或實體媒體 GUID。 所有 GUID 的類型都必須相同。

[in] dwType

在 lpObjectId 參數中指定的物件識別碼類型。 此參數可以是 NtmsObjectsTypes 列舉類型的下列其中一個值：NTMS_LIBRARY、NTMS_MEDIA_TYPE或NTMS_PHYSICAL_MEDIA。

[in] dwCount

lpObjectId 中的物件標識碼數目。

傳回值

此函式會傳回下列其中一個值。

值 意義
ERROR_INVALID_HANDLE
 會話或偵測句柄無效。
ERROR_INVALID_PARAMETER
 物件類型無效。
ERROR_INVALID_LIBRARY
 找不到指定的連結庫。
ERROR_INVALID_MEDIA
 找不到指定的媒體或類型。
ERROR_SUCCESS
 運算子要求已取消。

備註

您可以直接透過傳遞連結庫 GUID 或間接傳遞實體媒體或媒體類型 GUID 來指定裝置。 使用間接規格時，會偵測可能包含媒體或媒體類型的所有獨立連結庫。 所有指定的裝置都會繼續偵測到，直到 使用 EndNtmsDeviceChangeDetection 函式 關閉裝置變更偵測句柄為止。

此函式也可用來輪詢指定裝置中已變更的媒體。 開啟分葉節點或實作重新整理選項時，通常會由UI使用。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 ntmsapi.h
程式庫 Ntmsapi.lib
Dll Ntmsapi.dll

另請參閱

BeginNtmsDeviceChangeDetection

變更偵測函式

EndNtmsDeviceChangeDetection