通过

SetNtmsObjectInformationA 函数 （ntmsapi.h）

  • 项目

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

SetNtmsObjectInformation 函数更改指定对象的信息结构。

语法

DWORD SetNtmsObjectInformationA(
  [in] HANDLE                    hSession,
  [in] LPNTMS_GUID               lpObjectId,
  [in] LPNTMS_OBJECTINFORMATIONA lpInfo
);

参数

[in] hSession

OpenNtmsSession 函数返回的会话句柄。

[in] lpObjectId

RSM 对象的唯一标识符。

[in] lpInfo

指向 NTMS_OBJECTINFORMATION 结构的指针。

返回值

此函数返回以下值之一。

价值 意义
ERROR_ACCESS_DENIED
 NTMS_MODIFY_ACCESS或NTMS_CONTROL_ACCESS被拒绝写入的对象，或者不允许对指定的对象类型进行任何修改。 请参阅“备注”。
ERROR_SUCCESS
 函数成功。
ERROR_DATABASE_FAILURE
 数据库不可访问或损坏。
ERROR_DATABASE_FULL
 数据库已满。
ERROR_INVALID_HANDLE
 会话句柄缺失或无效。
ERROR_INVALID_PARAMETER
 对象 ID 或信息结构缺失，或者对象信息大小或对象类型无效。
ERROR_NOT_ENOUGH_MEMORY
 处理过程中发生分配失败。
ERROR_OBJECT_NOT_FOUND
 对象 ID 无效。

言论

必须先设置信息大小和类型，然后才能使用 SetNtmsObjectInformation。

对象的所有可写属性都从 NTMS_OBJECTINFORMATION 结构中读取，并写入数据库，而不考虑此应用程序调用 GetNtmsObjectInformation 函数和 SetNtmsObjectInformation 函数之间的任何写入操作。 因此，可能会丢失更改。

为了避免不可预知的结果，应用程序必须在 调用 SetNtmsObjectInformation之前调用 GetNtmsObjectInformation。 如上所述，SetNtmsObjectInformation 更新所有可写成员，因此应用程序负责为所有可写成员提供值。

下面是具有可更新的成员的对象列表。

对象 成员
NTMS_CHANGER szDescription 需要NTMS_MODIFY_ACCESS库。

Windows XP： 无需任何访问权限。
NTMS_CHANGER_TYPE szDescription 需要计算机NTMS_MODIFY_ACCESS。

Windows XP： 无需任何访问权限。
NTMS_COMPUTER dwMediaPoolPolicy
 
dwLibRequestFlags
 
dwLibRequestPurgeTime
 
dwOpRequestFlags
 
dwOpRequestPurgeTime
 
szDescription 需要计算机NTMS_MODIFY_ACCESS。

Windows XP： 无需任何访问权限。
NTMS_DRIVE dwDeferDismountDelay
 
szDescription 需要NTMS_MODIFY_ACCESS库。

Windows XP： 无需任何访问权限。
NTMS_DRIVE_TYPE szDescription 需要计算机NTMS_MODIFY_ACCESS。

Windows XP： 无需任何访问权限。
NTMS_IEDOOR MaxOpenSecs
 
szDescription 需要NTMS_MODIFY_ACCESS库。

Windows XP： 无需任何访问权限。
NTMS_IEPORT MaxExtendSecs
 
szDescription 需要NTMS_MODIFY_ACCESS库。

Windows XP： 无需任何访问权限。
NTMS_LIBRARY 自动恢复
 
dwCleanerUsesRemaining
 
dwFlags
 
InventoryMethod
 
szDescription
 
szName 需要NTMS_CONTROL_ACCESS库。
NTMS_LIBREQUEST szDescription 需要NTMS_MODIFY_ACCESS库。

Windows XP： 无需任何访问权限。
NTMS_LOGICAL_MEDIA szDescription
 
szName 需要NTMS_MODIFY_ACCESS逻辑媒体的媒体池。

Windows XP： 无需任何访问权限。
NTMS_MEDIA_POOL AllocationPolicy
 
DeallocationPolicy
 
dwMaxAllocates
 
MediaType
 
szDescription
 
szName 需要NTMS_MODIFY_ACCESS媒体池。

Windows XP： 需要媒体池NTMS_CONTROL_ACCESS。
NTMS_MEDIA_TYPE szDescription 需要计算机NTMS_MODIFY_ACCESS。

Windows XP： 无需任何访问权限。
NTMS_OPREQUEST szDescription 需要计算机NTMS_MODIFY_ACCESS。

Windows XP： 无需任何访问权限。
NTMS_PARTITION szName
 
szDescription 需要NTMS_MODIFY_ACCESS到侧的媒体池。

Windows XP： 需要NTMS_CONTROL_ACCESS一侧的媒体池。
NTMS_PHYSICAL_MEDIA szDescription
 
szName 需要NTMS_MODIFY_ACCESS媒体池。

Windows XP： 无需任何访问权限。
NTMS_STORAGESLOT szDescription 需要NTMS_MODIFY_ACCESS库。

Windows XP： 无需任何访问权限。
 

注意

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

要求

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

另请参阅

GetNtmsObjectInformation

GetNtmsObjectSecurity

NTMS_OBJECTINFORMATION

对象管理功能