DisableNtmsObject 函数 (ntmsapi.h)

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

DisableNtmsObject 函数禁用指定的 RSM 对象。

语法

DWORD DisableNtmsObject(
  [in] HANDLE      hSession,
  [in] DWORD       dwType,
  [in] LPNTMS_GUID lpObjectId
);

[in] hSession

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

[in] dwType

RSM 对象类型。此参数可以是 NtmsObjectsTypes 枚举类型的下列值之一。

[in] lpObjectId

RSM 对象的唯一标识符。

此函数返回以下值之一。

值	含义
ERROR_ACCESS_DENIED	拒绝对包含对象的库NTMS_MODIFY_ACCESS。可能存在其他安全错误，但表示存在安全子系统错误。 Windowsxp：拒绝对包含对象的库NTMS_CONTROL_ACCESS。可能存在其他安全错误，但表示存在安全子系统错误。
ERROR_DATABASE_FAILURE	数据库不可访问或已损坏。
ERROR_INVALID_HANDLE	会话句柄缺失或无效。
ERROR_INVALID_PARAMETER	缺少对象 ID 或对象类型无效。 (如果对象类型不是NTMS_LIBRARY、NTMS_DRIVE或NTMS_PHYSICAL_MEDIA，则 )
ERROR_INVALID_STATE	对象已被禁用。
ERROR_LIBRARY_OFFLINE	库 ID 是指无法启用或禁用的线下库。
ERROR_OBJECT_NOT_FOUND	对象无效。
ERROR_SUCCESS	禁用已排队。

DisableNtmsObject 函数将指定对象的 disable 命令排队。命令排队时，函数成功返回。如果 RSM 正忙，该命令可能需要一些时间才能完成。禁用介质后，RSM 将呈现媒体的所有端和关联的逻辑媒体不可用。对禁用媒体的所有请求返回错误。

若要从服务中删除驱动器或介质更换器，必须先禁用驱动器或介质更换器。

禁用对象包含的所有对象也会被禁用。例如，禁用一部分物理介质会禁用所有方面。如果可能，禁用驱动器时，驱动器中的介质将被移除并放置在其插槽中。