共用方式為

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
 遺漏物件標識碼。
ERROR_NO_SECURITY_ON_OBJECT
 此物件沒有安全性資訊。
ERROR_OBJECT_NOT_FOUND
 物件標識碼無效。
ERROR_SUCCESS
 函式成功。

備註

RSM 安全性使用標準安全性描述元和信息成員。 這可讓標準安全性對話框用來選取 RSM 安全性。 如需詳細資訊，請參閱 SetPrivateObjectSecurity 函式。 如需 RSM 安全性的詳細資訊，請參閱 RSM 安全性。

規格需求

需求 值
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 ntmsapi.h
程式庫 Ntmsapi.lib
Dll Ntmsapi.dll

另請參閱

EnumerateNtmsObject

物件管理函式

SetNtmsObjectSecurity