GROUP_POLICY_OBJECTW構造体 (userenv.h)

[アーティクル]
08/26/2023

GROUP_POLICY_OBJECT構造は、GPO リスト内の GPO に関する情報を提供します。

構文

typedef struct _GROUP_POLICY_OBJECTW {
  DWORD                        dwOptions;
  DWORD                        dwVersion;
  LPWSTR                       lpDSPath;
  LPWSTR                       lpFileSysPath;
  LPWSTR                       lpDisplayName;
  WCHAR                        szGPOName[50];
  GPO_LINK                     GPOLink;
  LPARAM                       lParam;
  struct _GROUP_POLICY_OBJECTW *pNext;
  struct _GROUP_POLICY_OBJECTW *pPrev;
  LPWSTR                       lpExtensions;
  LPARAM                       lParam2;
  LPWSTR                       lpLink;
} GROUP_POLICY_OBJECTW, *PGROUP_POLICY_OBJECTW;

メンバー

dwOptions

リンクオプションを指定します。このメンバーには、次のいずれかの値を指定できます。

GPO_FLAG_DISABLE

この GPO は無効になっています。

GPO_FLAG_FORCE

この GPO のポリシー設定を、後続の GPO のポリシー設定でオーバーライドしないでください。

dwVersion

GPO のバージョン番号を指定します。

lpDSPath

GPO のディレクトリサービス部分へのパスを指定する文字列へのポインター。

lpFileSysPath

GPO のファイルシステム部分へのパスを指定する文字列へのポインター。

lpDisplayName

GPO の表示名へのポインター。

szGPOName[50]

GPO を識別する一意の名前を指定する文字列へのポインター。

GPOLink

GPO のリンク情報を指定します。このメンバーには、次のいずれかの値を指定できます。

GPLinkUnknown

リンク情報は使用できません。

GPLinkMachine

GPO がコンピューター (ローカルまたはリモート) にリンクされています。

GPLinkSite

GPO はサイトにリンクされています。

GPLinkDomain

GPO はドメインにリンクされています。

GPLinkOrganizationalUnit

GPO は組織単位にリンクされています。

lParam

ユーザー指定のデータ。

pNext

リスト内の次の GPO へのポインター。

pPrev

リスト内の前の GPO へのポインター。

lpExtensions

この GPO にデータが格納されている拡張機能。形式は、角かっこでグループ化された GUIDの文字列です。詳細については、「解説」を参照してください。

lParam2

ユーザー指定のデータ。

lpLink

この GPO がリンクされている Active Directory サイト、ドメイン、またはorganizationユニットへのパス。 GPO がローカル GPO にリンクされている場合、このメンバーは "ローカル" になります。

解説

各 GPO には、複数のスナップイン拡張機能で処理する必要があるデータが含まれている可能性があります。したがって、 lpExtensions メンバー内のデータは、拡張機能とスナップイン拡張機能を識別する一連の GUID として編成されます。データ形式は次のとおりです。

[ext_guid1, snap_in_guid1, snap_in_guid2, ...] 
[ext_guid2, snap_in_guid3, snap_in_guid4, ...]

最初に、始めかっこ "[" の後に拡張機能の GUID が 続きます。次に、GPO にデータを格納しているスナップイン拡張機能を識別する GUID を1 つ以上見つけます。拡張機能の最後のスナップイン GUID の後に、右角かっこ "]" があります。このパターンは、次の拡張機能に対して繰り返されます。

注意

userenv.h ヘッダーは、GROUP_POLICY_OBJECTをエイリアスとして定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件


サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
Header	userenv.h

Share via