共用方式為

iEffectivePermission：：GetEffectivePermission 方法 (aclui.h)

  • 發行項

GetEffectivePermission 方法會傳回物件類型的有效許可權。

語法

HRESULT GetEffectivePermission(
  [in]  const GUID           *pguidObjectType,
  [in]  PSID                 pUserSid,
  [in]  LPCWSTR              pszServerName,
  [in]  PSECURITY_DESCRIPTOR pSD,
  [out] POBJECT_TYPE_LIST    *ppObjectTypeList,
  [out] ULONG                *pcObjectTypeListLength,
  [out] PACCESS_MASK         *ppGrantedAccessList,
  [out] ULONG                *pcGrantedAccessListLength
);

參數

[in] pguidObjectType

正在查詢其許可權的物件型別 GUID 。

[in] pUserSid

SID 結構的指標，表示正在判斷有效許可權的安全性主體。

[in] pszServerName

代表伺服器名稱之 Null 終止寬字元字串的指標。

[in] pSD

SECURITY_DESCRIPTOR 結構的指標，表示對象的安全性描述項。 安全性描述項是用來執行存取檢查。

[out] ppObjectTypeList

指向 OBJECT_TYPE_LIST 結構的指標，表示物件之物件樹狀結構中的物件類型陣列。 如果物件不支援屬性存取，請使用下列技術來指定 OBJECT_TYPE_LIST的值。

#include <windows.h>

OBJECT_TYPE_LIST g_DefaultOTL[] = {
 {0, 0, (LPGUID)&GUID_NULL},
};

[out] pcObjectTypeListLength

ULONG 的指標，可接收 ppObjectTypeList 所指向的物件類型計數。

[out] ppGrantedAccessList

接收授與存取遮罩數位 之ACCESS_MASK 指標的指標。 操作系統會使用 LocalFree 釋放配置給此參數的記憶體。

[out] pcGrantedAccessListLength

ULONG 變數的指標，接收 ppGrantedAccessList 參數所指向的授與存取遮罩計數。

傳回值

如果函式成功，傳回值會S_OK。

如果函式失敗，傳回值為表示錯誤的 HRESULT 。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

規格需求

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