共用方式為

IAccessControl：：GrantAccessRights 方法 (iaccess.h)

  • 發行項

將新的訪問許可權清單與對象上現有的訪問許可權合併。

語法

HRESULT GrantAccessRights(
  [in] PACTRL_ACCESSW pAccessList
);

參數

[in] pAccessList

ACTRL_ACCESS 結構的指標，其中包含物件的存取清單陣列。

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

將新的訪問許可權清單與現有的訪問許可權合併，可確保物件至少具有指定的訪問許可權。 此合併程式包含新增新的拒絕訪問許可權，再加入舊的拒絕訪問許可權，以及現有允許許可權之前的新允許訪問許可權。 不會移除任何現有的許可權。

在合併之後，對象的訪問許可權會依下列方式排序：

  1. [拒絕新的存取]
  2. [拒絕舊存取]
  3. [允許新的存取]
  4. [允許舊存取]
系統提供的 [ACTRL_ACCESS] ( 實作。/accctrl/ns-accctrl-explicit_access_a.md) 結構設為 1。 此外，ACTRL_PROPERTY_ENTRYW 結構的 lpProperty 成員必須是 NULL，表示存取專案清單適用於物件本身。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 iaccess.h

另請參閱

IAccessControl