通过

GetNtmsObjectSecurity 函数 (ntmsapi.h)

  • 项目

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

GetNtmsObjectSecurity 函数读取指定 RSM 对象的安全描述符。

语法

DWORD GetNtmsObjectSecurity(
  [in]  HANDLE               hSession,
  [in]  LPNTMS_GUID          lpObjectId,
  [in]  DWORD                dwType,
  [in]  SECURITY_INFORMATION RequestedInformation,
  [out] PSECURITY_DESCRIPTOR lpSecurityDescriptor,
  [in]  DWORD                nLength,
  [out] LPDWORD              lpnLengthNeeded
);

参数

[in] hSession

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

[in] lpObjectId

RSM 对象的唯一标识符。

[in] dwType

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

[in] RequestedInformation

一个SECURITY_INFORMATION值，该值指定请求的安全数据。

[out] lpSecurityDescriptor

指向接收安全描述符 的SECURITY_DESCRIPTOR 结构的指针。

[in] nLength

描述符的长度。

[out] lpnLengthNeeded

缓冲区的所需长度（如果对于安全描述符不够大），以字节为单位。

返回值

此函数返回以下值之一。

值 含义
ERROR_ACCESS_DENIED
 READ_CONTROL拒绝访问 对象。

Windowsxp： 无需任何访问权限。
ERROR_DATABASE_FAILURE
 数据库不可访问或已损坏。
ERROR_INVALID_HANDLE
 会话句柄缺失或无效。
ERROR_INVALID_PARAMETER
 缺少对象 ID。
ERROR_NO_SECURITY_ON_OBJECT
 此对象没有安全信息。
ERROR_OBJECT_NOT_FOUND
 对象 ID 无效。
ERROR_SUCCESS
 函数成功。

注解

RSM 安全性使用标准安全描述符和信息成员。 这允许使用标准安全对话框来选择 RSM 安全性。 有关详细信息，请参阅 SetPrivateObjectSecurity 函数。 有关 RSM 安全性的详细信息，请参阅 RSM 安全性。

要求

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

另请参阅

EnumerateNtmsObject

对象管理功能

SetNtmsObjectSecurity