IAccessControl::GetAllAccessRights 方法 (iaccess.h)
取得指定物件的存取權和/或擁有者和群組的整個清單。
語法
HRESULT GetAllAccessRights(
[in] LPWSTR lpProperty,
[out] PACTRL_ACCESSW_ALLOCATE_ALL_NODES *ppAccessList,
[out] PTRUSTEEW *ppOwner,
[out] PTRUSTEEW *ppGroup
);
參數
[in] lpProperty
屬性的名稱。 如果您使用 IAccessControl 的 COM 實作,此參數必須是 NULL。
[out] ppAccessList
接收存取清單結構指標的指標變數位址。 此參數不能 ACTRL_ACCESS。
如果呼叫成功,呼叫端必須使用 CoTaskMemFree 函式釋放配置的記憶體。 請注意,記憶體會配置 (all_nodes) ,這表示所有子結構都會配置在一個區塊中。 因此,整個數據結構必須由 CoTaskMemFree 的單一呼叫釋放。
[out] ppOwner
可接收擁有者資訊的 TRUSTEE 結構的指標。 如果此參數不是 NULL ,而且函式成功,呼叫端必須使用 CoTaskMemFree 釋放記憶體。
[out] ppGroup
接收群組資訊 之 TRUSTEE 結構的指標。 如果此參數不是 NULL ,而且函式成功,呼叫端必須使用 CoTaskMemFree 釋放記憶體。
傳回值
如果此方法成功,則會傳回 S_OK。 否則,它會傳回 HRESULT 錯誤碼。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | iaccess.h |