通过

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
Library Ntmsapi.lib
DLL Ntmsapi.dll

另请参阅

BeginNtmsDeviceChangeDetection

更改检测函数

EndNtmsDeviceChangeDetection