GetNtmsObjectInformation 函数 (ntmsapi.h)
[从 Windows 7 和 Windows Server 2008 R2 起,可移动存储管理器 不再可用。]
GetNtmsObjectInformation 函数返回指定对象的信息结构。
语法
DWORD GetNtmsObjectInformation(
[in] HANDLE hSession,
[in] LPNTMS_GUID lpObjectId,
[out] LPNTMS_OBJECTINFORMATION lpInfo
);
参数
[in] hSession
OpenNtmsSession 函数返回的会话的句柄。
[in] lpObjectId
RSM 对象的唯一标识符。
[out] lpInfo
指向接收对象信息的 NTMS_OBJECTINFORMATION 结构的指针。
返回值
此函数返回以下值之一。
值 | 含义 |
---|---|
|
拒绝向 对象或其容器NTMS_USE_ACCESS。 其他安全错误也可能存在,但它们表示存在安全子系统错误。
Windowsxp: 无需任何访问权限。 |
|
会话句柄缺失或无效。 |
|
缺少对象 ID 或信息结构,或者对象信息大小或对象类型无效。 |
|
处理期间发生分配失败。 |
|
对象 ID 无效。 |
|
函数成功。 |
注解
在使用 GetNtmsObjectInformation 函数之前,必须在 lpInfo 参数中正确设置信息结构的信息大小和类型。
为了避免不可预测的结果,应用程序必须在调用 SetNtmsObjectInformation 函数之前调用 GetNtmsObjectInformation 函数。 SetNtmsObjectInformation 函数更新NTMS_OBJECTINFORMATION结构的所有可写成员,因此应用程序负责为所有可写成员提供值。
下面是需要特殊访问权限的对象列表。
Object | Access |
---|---|
NTMS_CHANGER | 需要NTMS_USE_ACCESS库。 |
NTMS_CHANGER_TYPE | 需要NTMS_USE_ACCESS计算机。 |
NTMS_COMPUTER | 需要NTMS_USE_ACCESS计算机。 |
NTMS_DRIVE | 需要NTMS_USE_ACCESS库。 |
NTMS_DRIVE_TYPE | 需要NTMS_USE_ACCESS计算机。 |
NTMS_IEDOOR | 需要NTMS_USE_ACCESS库。 |
NTMS_IEPORT | 需要NTMS_USE_ACCESS库。 |
NTMS_LIBRARY | 需要NTMS_USE_ACCESS库。 |
NTMS_LIBREQUEST | 需要NTMS_USE_ACCESS库。 |
NTMS_LOGICAL_MEDIA | 需要NTMS_USE_ACCESS逻辑媒体的媒体池。 |
NTMS_MEDIA_TYPE | 需要NTMS_USE_ACCESS计算机。 |
NTMS_OPREQUEST | 需要NTMS_USE_ACCESS计算机。 |
NTMS_PARTITION | 需要NTMS_USE_ACCESS一侧的媒体池。 |
NTMS_PHYSICAL_MEDIA | 需要NTMS_USE_ACCESS媒体池。 |
NTMS_STORAGESLOT | 需要NTMS_USE_ACCESS库。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | ntmsapi.h |
Library | Ntmsapi.lib |
DLL | Ntmsapi.dll |