BuildExplicitAccessWithNameA 関数 (aclapi.h)
BuildExplicitAccessWithName 関数は、呼び出し元によって指定されたデータを使用して EXPLICIT_ACCESS 構造体を初期化します。 トラスティは名前文字列で識別されます。
構文
void BuildExplicitAccessWithNameA(
[in, out] PEXPLICIT_ACCESS_A pExplicitAccess,
[in, optional] LPSTR pTrusteeName,
[in] DWORD AccessPermissions,
[in] ACCESS_MODE AccessMode,
[in] DWORD Inheritance
);
パラメーター
[in, out] pExplicitAccess
初期化する EXPLICIT_ACCESS 構造体へのポインター。
BuildExplicitAccessWithName 関数はメモリを割り当てません。 このパラメーターは NULL
[in, optional] pTrusteeName
のトラスティ 構造体の ptstrName メンバーのトラスティの名前を含む、null-terminated 文字列へのポインター。 BuildExplicitAccessWithName 関数は、のトラスティ 構造体の他のメンバーを次のように設定します。
| 価値 | 意味 |
|---|---|
|
NULL |
|
NO_MULTIPLE_TRUSTEE |
|
TRUSTEE_IS_NAME |
|
TRUSTEE_IS_UNKNOWN |
[in] AccessPermissions
[in] AccessMode
EXPLICIT_ACCESS 構造体の grfAccessMode メンバーのアクセス モードを指定します。 アクセス モードは、アクセス制御エントリ (ACE) が、指定された権限を許可、拒否、または監査するかどうかを示します。 随意アクセス制御リスト (DACL) の場合、このパラメーターには、ACCESS_MODE 列挙体の値のいずれかを指定できます。 システム アクセス制御リスト (SACL) の場合、このパラメーターは ACCESS_MODE 値の組み合わせにすることができます。
[in] Inheritance
EXPLICIT_ACCESS 構造体の grfInheritance メンバーの継承型を指定します。 この値は、他のコンテナーまたはオブジェクトが、ACL がアタッチされているプライマリ オブジェクトから ACE を継承できるかどうかを決定するビット フラグのセットです。 このメンバーの値は、ACE_HEADER 構造体の AceFlags メンバーの継承部分 (下位バイト) に対応します。 このパラメーターは、ACE が継承できないことを示すためにNO_INHERITANCEすることも、次の値の組み合わせにすることもできます。
戻り値
何一つ
備考
手記
aclapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして BuildExplicitAccessWithName を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | aclapi.h |
| ライブラリ | Advapi32.lib |
| DLL | Advapi32.dll |
関連項目
GetExplicitEntriesFromAcl の