GROUP_POLICY_OBJECTW構造体 (userenv.h)

[アーティクル]
11/20/2024

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 サイト、ドメイン、または組織単位へのパス。 GPO がローカル GPO にリンクされている場合、このメンバーは "Local" になります。

備考

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

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

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

手記

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

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista
サポートされる最小サーバー	Windows Server 2008
ヘッダー	userenv.h

次の方法で共有