共用方式為

SetNtmsObjectSecurity 函式 (ntmsapi.h)

  • 發行項

[從 Windows 7 和 Windows Server 2008 R2 起，已不再提供卸載式儲存管理員 。]

SetNtmsObjectSecurity函式會寫入指定 RSM 物件的安全性描述元。

語法

DWORD SetNtmsObjectSecurity(
  [in] HANDLE               hSession,
  [in] LPNTMS_GUID          lpObjectId,
  [in] DWORD                dwType,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR lpSecurityDescriptor
);

參數

[in] hSession

OpenNtmsSession 函式所傳回之會話的控制碼。

[in] lpObjectId

RSM 物件的唯一識別碼。

[in] dwType

RSM 物件類型。 如需物件類型清單，請參閱 NtmsObjectsTypes。

[in] SecurityInformation

SECURITY_INFORMATION值，指定要寫入 RSM 物件的安全性資訊。

[in] lpSecurityDescriptor

SECURITY_DESCRIPTOR結構的指標，指定要寫入 RSM 物件的安全性描述項：NTMS_USE_ACCESS、NTMS_CONTROL_ACCESS或NTMS_MODIFY_ACCESS。

傳回值

此函式會傳回下列其中一個值。

值 意義
ERROR_ACCESS_DENIED
 修改安全描述項所需的許可權會遭到拒絕。
ERROR_DATABASE_FAILURE
 資料庫無法存取或損毀。
ERROR_DATABASE_FULL
 資料庫已滿。
ERROR_INVALID_HANDLE
 會話控制碼遺失或無效。
ERROR_INVALID_PARAMETER
 遺漏物件識別碼。
ERROR_NO_SECURITY_ON_OBJECT
 此物件沒有安全性資訊。
ERROR_OBJECT_NOT_FOUND
 物件識別碼無效。
ERROR_SUCCESS
 函式成功。

備註

如果應用程式使用 SetNtmsObjectSecurity 來設定物件的 ACL) (選擇性存取控制清單，則應用程式必須具有WRITE_DAC許可權或成為物件的擁有者。

如果應用程式使用 SetNtmsObjectSecurity 來設定物件的系統 ACL，則必須為應用程式啟用SE_SECURITY_NAME許可權。 如需詳細資訊，請參閱 SetPrivateObjectSecurity 函式。 如需 RSM 安全性的詳細資訊，請參閱 RSM 安全性。

需求

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

另請參閱

EnumerateNtmsObject

GetNtmsObjectSecurity

物件管理函式