GetAce 関数 (securitybaseapi.h)

GetAce 関数は、アクセス制御リスト (ACL) 内のアクセス制御エントリ (ACE) へのポインターを取得します。

構文

BOOL GetAce(
  [in]  PACL   pAcl,
  [in]  DWORD  dwAceIndex,
  [out] LPVOID *pAce
);

パラメーター

[in] pAcl

取得する ACE を含む ACL へのポインター。

[in] dwAceIndex

取得する ACE のインデックス。 値 0 は、ACL の最初の ACE、1 から 2 番目の ACE までの値に対応します。

[out] pAce

関数が ACE のアドレスに設定するポインターへのポインター。

戻り値

関数が成功した場合、関数は 0 以外の値を返します。

関数が失敗すると、0 が返されます。 詳細なエラー情報を得るには、GetLastError を呼び出します。

要件

   
サポートされている最小のクライアント Windows XP [デスクトップ アプリ | UWP アプリ]
サポートされている最小のサーバー Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ]
対象プラットフォーム Windows
ヘッダー securitybaseapi.h (Windows.h を含む)
Library Advapi32.lib
[DLL] Advapi32.dll

関連項目

AddAccessAllowedAce

AddAccessDeniedAce

AddAce

AddAuditAccessAce

GetAclInformation

InitializeAcl

低レベルのAccess Control

低レベルのAccess Control関数