GetAppliedGPOListW 関数 (userenv.h)

[アーティクル]
03/03/2024

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