通过

GetNtmsObjectAttributeA 函数 （ntmsapi.h）

  • 项目

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

GetNtmsObjectAttribute 函数从指定的 RSM 对象检索扩展属性（命名为私有数据）。

语法

DWORD GetNtmsObjectAttributeA(
  [in]      HANDLE      hSession,
  [in]      LPNTMS_GUID lpObjectId,
  [in]      DWORD       dwType,
  [in]      LPCSTR      lpAttributeName,
  [out]     LPVOID      lpAttributeData,
  [in, out] LPDWORD     lpAttributeSize
);

参数

[in] hSession

OpenNtmsSession 函数返回的会话句柄。

[in] lpObjectId

要从中检索数据的对象的唯一标识符。

[in] dwType

RSM 对象类型。 有关对象类型的列表，请参阅 NtmsObjectsTypes。

[in] lpAttributeName

要检索其数据的扩展属性的名称。

[out] lpAttributeData

指向接收数据的缓冲区的指针。

[in, out] lpAttributeSize

输入上的数据缓冲区的大小（以字节为单位）。 在输出中，数据的实际大小（以字节为单位）。

返回值

此函数返回以下值之一。

价值 意义
ERROR_ACCESS_DENIED
 拒绝对对象或其容器NTMS_USE_ACCESS。 其他安全错误也是可能的，但它们将指示安全子系统错误。

Windows XP：无需任何访问权限。
ERROR_DATABASE_FAILURE
 数据库查询或更新失败。
ERROR_INSUFFICIENT_BUFFER
 未正确指定缓冲区大小。 lpAttributeSize 参数中返回正确的大小。
ERROR_INVALID_HANDLE
 hSession 参数中指定的值 NULL 或无效。
ERROR_INVALID_PARAMETER
 指针 NULL 或无效。
ERROR_NOT_CONNECTED
 无法连接到 RSM 服务。
ERROR_OBJECT_NOT_FOUND
 找不到指定的属性。
ERROR_SUCCESS
 函数成功。

言论

必须在 RSM 服务器上执行 GetNtmsObjectAttribute 函数。 由于不同体系结构的系统之间未分配字节的缓冲区，因此远程执行此函数可能会导致不可预知的结果。

下面是需要特殊访问权限的对象列表。

对象 访问
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_POOL 需要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库。
 

注意

ntmsapi.h 标头将 GetNtmsObjectAttribute 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

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

另请参阅

EnumerateNtmsObject

对象管理功能

SetNtmsObjectAttribute