GetAppliedGPOListA 関数 (userenv.h)

GetAppliedGPOList 関数は、指定したユーザーまたはコンピューターに適用された GPO の一覧を取得します。

構文

USERENVAPI DWORD GetAppliedGPOListA(
  [in]  DWORD                 dwFlags,
  [in]  LPCSTR                pMachineName,
  [in]  PSID                  pSidUser,
  [in]  GUID                  *pGuidExtension,
  [out] PGROUP_POLICY_OBJECTA *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
ターゲット プラットフォーム の	ウィンドウズ
ヘッダー	userenv.h
ライブラリ	Userenv.lib
DLL	Userenv.dll

関連項目

FreeGPOList を する

GROUP_POLICY_OBJECT

GetGPOList を する

グループ ポリシー関数の

グループ ポリシーの概要