IdentifyNtmsSlot 函数 (ntmsapi.h)

[从 Windows 7 和 Windows Server 2008 R2 起，可移动存储管理器 不再可用。]

IdentifyNtmsSlot 函数标识库中指定槽中的媒体。 标识完成后，命令将返回。

语法

DWORD IdentifyNtmsSlot(
  [in] HANDLE      hSession,
  [in] LPNTMS_GUID lpSlotId,
  [in] DWORD       dwOption
);

参数

[in] hSession

OpenNtmsSession 函数返回的会话的句柄。

[in] lpSlotId

要标识的槽对象的唯一标识符。

[in] dwOption

此参数的取值可为下列值之一：

值	含义
NTMS_DISMOUNT_DEFERRED	介质标识完成后，将介质保留在驱动器中，就好像已使用“延迟”选项将其卸载一样。
NTMS_DISMOUNT_IMMEDIATE	介质标识完成后，卸载驱动器中的介质。

返回值

此函数返回以下值之一。

值	含义
ERROR_ACCESS_DENIED	拒绝访问一个或多个 RSM 对象。
ERROR_INVALID_HANDLE	hSession 参数中指定的值无效。
ERROR_INVALID_PARAMETER	槽 ID 或 dwOption 无效。
ERROR_SUCCESS	函数成功。

注解

如果槽为空，则函数返回ERROR_SUCCESS，但不显示新的媒体记录。

要求

要求	值
最低受支持的客户端	Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	ntmsapi.h
Library	Ntmsapi.lib
DLL	Ntmsapi.dll

另请参阅

InventoryNtmsLibrary

库控制函数