GetAppliedGPOListW 関数 (userenv.h)
GetAppliedGPOList 関数は、指定したユーザーまたはコンピューターに適用された GPO の一覧を取得します。
構文
USERENVAPI DWORD GetAppliedGPOListW(
[in] DWORD dwFlags,
[in] LPCWSTR pMachineName,
[in] PSID pSidUser,
[in] GUID *pGuidExtension,
[out] PGROUP_POLICY_OBJECTW *ppGPOList
);
パラメーター
[in] dwFlags
ポリシーの種類を示す 値。 このパラメーターには、次の値を指定できます。
GPO_LIST_FLAG_MACHINE
コンピューター ポリシーに関する情報を取得します。
この値を指定しない場合、関数はユーザー ポリシー情報のみを取得します。
[in] pMachineName
リモート コンピューターの名前へのポインター。 名前の形式は "\\computer_name" です。 このパラメーターが NULL の場合は、ローカル コンピューター名が使用されます。
[in] pSidUser
ユーザーの SID を指定する 値。 pMachineName が NULL ではなく、dwFlags でユーザー ポリシーが指定されている場合、pSidUser をNULL にすることはできません。
pMachineName が NULL で、pSidUser が NULL の場合、ユーザーは現在ログオンしているユーザーです。 pMachineName が NULL で、pSidUser が NULL でない場合、ユーザーはローカル コンピューターの pSidUser によって表されます。 詳細については、「 セキュリティ識別子」を参照してください。
[in] pGuidExtension
拡張機能の GUID を 示す 値です。
[out] ppGPOList
GPO 構造の一覧を受け取るポインター。 詳細については、「 GROUP_POLICY_OBJECT」を参照してください。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS。 それ以外の場合、関数はシステム エラー コードを返します。 エラー コードの完全な一覧については、「 システム エラー コード 」またはヘッダー ファイル WinError.h を参照してください。
注釈
GPO リストの処理が完了したら解放するには、 FreeGPOList 関数を呼び出します。
注意
userenv.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして GetAppliedGPOList を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | userenv.h |
| Library | Userenv.lib |
| [DLL] | Userenv.dll |