グループ ポリシー API

グループ ポリシー API テクノロジの概要。

グループ ポリシー API を開発するには、次のヘッダーが必要です。

• gpedit.h

このテクノロジのプログラミング ガイダンスについては、次を参照してください。

• グループ ポリシー API

列挙

INSTALLSPECTYPE INSTALLSPECTYPE 列挙値は、グループ ポリシー アプリケーションを InstallApplication 関数に指定する方法を定義します。 値は、INSTALLDATA の Type メンバーで使用されます。

関数

BrowseForGPO BrowseForGPO 関数は、ユーザーが GPO を開いたり作成したりできる GPO ブラウザー ダイアログ ボックスを作成します。
CreateGPOLink CreateGPOLink 関数は、指定した GPO と指定したサイト、ドメイン、または組織単位の間にリンクを作成します。
削除 Delete メソッドは GPO を削除します。
DeleteAllGPOLinks DeleteAllGPOLinks 関数は、指定したサイト、ドメイン、または組織単位のすべての GPO リンクを削除します。
DeleteGPOLink DeleteGPOLink 関数は、指定した GPO と指定したサイト、ドメイン、または組織単位の間のリンクを削除します。
EnterCriticalPolicySection EnterCriticalPolicySection 関数は、ポリシーのアプリケーションを一時停止して、アプリケーションがポリシー設定を安全に読み取ることができるようにします。
ExportRSoPData ExportRSoPData 関数は、RSoP 情報を含む WMI 名前空間をデータ ファイルにエクスポートします。 関数は、ImportRSoPData 関数を呼び出して WMI 名前空間にインポートできるデータ ファイルに情報を書き込みます。
FreeGPOListA FreeGPOList 関数は、GPO の指定されたリストを解放します。 (ANSI)
FreeGPOListW FreeGPOList 関数は、GPO の指定されたリストを解放します。 (Unicode)
GetAppliedGPOListA GetAppliedGPOList 関数は、指定したユーザーまたはコンピューターに適用された GPO の一覧を取得します。 (ANSI)
GetAppliedGPOListW GetAppliedGPOList 関数は、指定したユーザーまたはコンピューターに適用された GPO の一覧を取得します。 (Unicode)
GetDisplayName GetDisplayName メソッドは、GPO の表示名を取得します。 (IGPEInformation.GetDisplayName)
GetDisplayName GetDisplayName メソッドは、GPO の表示名を取得します。 (IGroupPolicyObject.GetDisplayName)
GetDSPath GetDSPath メソッドは、GPO の指定したセクションの Active Directory パスを取得します。
GetDSPath GetDSPath メソッドは、指定した GPO セクションのルートへの Active Directory パスを取得します。
GetEventLogEntryText GetEventLogEntryText メソッドは、イベント ログ内の特定のエントリのテキストを返します。
GetFileSysPath GetFileSysPath メソッドは、GPO の指定したセクションのファイル システム パスを返します。 パスは UNC 形式です。
GetFileSysPath GetFileSysPath メソッドは、指定した GPO セクションのルートへのファイル システム パスを取得します。 パスは UNC 形式です。
GetFlags GetFlags メソッドは、RSoP ユーザー インターフェイス セッションに関する情報を取得します。
GetGPOListA GetGPOList 関数は、指定したユーザーまたはコンピューターの GPO の一覧を取得します。 (ANSI)
GetGPOListW GetGPOList 関数は、指定したユーザーまたはコンピューターの GPO の一覧を取得します。 (Unicode)
GetHint GetHint メソッドは、この GPO をリンクできる Active Directory オブジェクトの種類を取得します。
GetLocalManagedApplications GetLocalManagedApplications 関数は、ターゲット コンピューターで実行して、そのコンピューター上のマネージド アプリケーションの一覧を取得できます。
GetMachineName GetMachineName メソッドは、リモート GPO のコンピューター名を取得します。 これは、OpenRemoteMachineGPO メソッドで指定された名前です。
GetManagedApplicationCategories GetManagedApplicationCategories 関数は、ドメインのアプリケーション カテゴリの一覧を取得します。 この一覧は、ドメイン内のすべてのユーザーで同じです。
GetManagedApplications GetManagedApplications 関数は、指定されたユーザー コンテキストの [プログラムの追加と削除 (ARP)] の [追加] ペインに表示されるアプリケーションの一覧を取得します。
GetName GetName メソッドは、GPO の一意の名前を取得します。 通常、この値は GUID です。
GetName GetName メソッドは、一意の GPO 名を取得します。
GetNamespace GetNameSpace メソッドは、RSoP データの表示元となる名前空間を取得します。
GetOptions GetOptions メソッドは、グループ ポリシー オブジェクト エディターに対してユーザーが選択したオプションを取得します。
GetOptions GetOptions メソッドは、GPO のオプションを取得します。
GetPath GetPath メソッドは、GPO へのパスを取得します。
GetPropertySheetPages GetPropertySheetPages メソッドは、GPO に関連付けられているプロパティ シート ページを取得します。
GetRegistryKey GetRegistryKey メソッドは、GPO の指定したセクションのレジストリ キーのルートへのハンドルを取得します。
GetRegistryKey GetRegistryKey メソッドは、指定した GPO セクションのレジストリ キーのルートへのハンドルを取得します。
GetType GetType メソッドは、編集中の GPO の型情報を取得します。 (IGPEInformation.GetType)
GetType GetType メソッドは、編集中の GPO の型情報を取得します。 (IGroupPolicyObject.GetType)
ImportRSoPData ImportRSoPData 関数は、RSoP データを含むデータ ファイルを WMI 名前空間にインポートします。 ファイルは、ExportRSoPData 関数の呼び出しによって生成されるファイルである必要があります。
InstallApplication InstallApplication 関数は、ドメインに属するターゲット ユーザーに展開されたアプリケーションをインストールできます。
LeaveCriticalPolicySection LeaveCriticalPolicySection 関数は、ポリシーのバックグラウンド アプリケーションを再開します。 この関数は、ポリシー セクションへのハンドルを閉じます。
[新規作成] New メソッドは、指定した表示名を持つ新しい GPO を Active Directory に作成します。 メソッドは、OpenDSGPO メソッドを使用して GPO を開きます。
OpenDSGPO OpenDSGPO メソッドは、指定した GPO を開き、必要に応じてレジストリ情報を読み込みます。
OpenLocalMachineGPO OpenLocalMachineGPO メソッドは、コンピューターの既定の GPO を開き、必要に応じてレジストリ情報を読み込みます。
OpenRemoteMachineGPO OpenRemoteMachineGPO メソッドは、指定されたリモート コンピューターの既定の GPO を開き、必要に応じてレジストリ情報を読み込みます。
PFNGENERATEGROUPPOLICY GenerateGroupPolicy コールバック関数は、計画モードで RSoP データを生成するときに各ポリシー拡張機能がエクスポートする必要があるアプリケーション定義のコールバック関数です。
PFNPROCESSGROUPPOLICY ProcessGroupPolicy 関数は、ポリシーの適用時に使用されるアプリケーション定義のコールバック関数です。
PFNPROCESSGROUPPOLICYEX ProcessGroupPolicyEx 関数は、ポリシーの適用時に使用されるアプリケーション定義のコールバック関数です。
PFNSTATUSMESSAGECALLBACK StatusMessageCallback 関数は、ポリシーの適用時にステータス メッセージを表示するために使用されるアプリケーション定義のコールバック関数です。
PolicyChanged PolicyChanged メソッドは、ポリシー設定が変更されたことをグループ ポリシー オブジェクト エディターに通知します。
ProcessGroupPolicyCompleted ProcessGroupPolicyCompleted 関数は、指定された拡張機能がポリシーの適用を完了したことをシステムに通知します。
ProcessGroupPolicyCompletedEx ProcessGroupPolicyCompletedEx 関数は、指定されたポリシー拡張機能がポリシーの適用を完了したことをシステムに通知します。 この関数は、ポリシーの結果セット (RSoP) ログの状態も報告します。
RefreshPolicy RefreshPolicy 関数を使用すると、ポリシーがクライアント コンピューターにすぐに適用されます。
RefreshPolicyEx RefreshPolicyEx 関数を使用すると、ポリシーがコンピューターにすぐに適用されます。 拡張関数を使用すると、適用するポリシー更新の種類を指定できます。
RegisterGPNotification RegisterGPNotification 関数を使用すると、ポリシーに変更があった場合にアプリケーションが通知を受け取ります。 ポリシーの変更が発生すると、指定したイベント オブジェクトがシグナル状態に設定されます。
RsopAccessCheckByType RSoPAccessCheckByType 関数は、セキュリティ記述子が RSOPTOKEN によって識別されたクライアントに対して、指定されたアクセス権のセットを許可するかどうかを決定します。
RsopFileAccessCheck RSoPFileAccessCheck 関数は、ファイルのセキュリティ記述子が、RSOPTOKEN によって識別されるクライアントに対して、指定されたファイル アクセス権のセットを付与するかどうかを決定します。
RsopResetPolicySettingStatus RSoPResetPolicySettingStatus 関数は、RSOP_PolicySetting インスタンスからRSOP_PolicySettingStatus インスタンスのリンクを解除します。
RsopSetPolicySettingStatus RSoPSetPolicySettingStatus 関数は、RSOP_PolicySettingStatusのインスタンスと RSOP_PolicySettingLink のインスタンスを作成します。 関数は、RSOP_PolicySettingStatusをそのRSOP_PolicySetting インスタンスにリンク (関連付けます) します。
および Save メソッドは、指定したレジストリ ポリシー設定をディスクに保存し、GPO のリビジョン番号を更新します。
SetDisplayName SetDisplayName メソッドは、GPO の表示名を設定します。
SetOptions SetOptions メソッドは、GPO のオプションを設定します。
UninstallApplication UninstallApplication 関数は、Windows インストーラー .msi ファイルを使用してセットアップとインストールを処理するグループ ポリシー アプリケーションをアンインストールします。
UnregisterGPNotification UnregisterGPNotification 関数は、指定されたポリシー通知ハンドルがポリシー変更通知の受信を解除します。

インターフェイス

IGPEInformation IGPEInformation インターフェイスは、Microsoft 管理コンソール (MMC) 拡張機能スナップインがグループ ポリシー オブジェクト エディターと通信するためのメソッドを提供します。 MMC の詳細については、Microsoft 管理コンソールを参照してください。
IGroupPolicyObject IGroupPolicyObject インターフェイスには、グループ ポリシー オブジェクト エディターを使用せずに GPO を直接作成および変更するメソッドが用意されています。
IRSOPInformation IRSOPInformation インターフェイスは、Microsoft 管理コンソール (MMC) 拡張機能スナップインが、メイン結果のポリシー セット (RSoP) スナップインと通信するためのメソッドを提供します。 MMC の詳細については、Microsoft 管理コンソールを参照してください。

構造

GPOBROWSEINFO GPOBROWSEINFO 構造体には、BROWSEForGPO 関数が GPO ブラウザー ダイアログ ボックスの初期化に使用する情報が含まれています。 ユーザーがダイアログ ボックスを閉じると、システムはこの構造のユーザーのアクションに関する情報を返します。
GROUP_POLICY_OBJECTA GROUP_POLICY_OBJECT構造は、GPO リスト内の GPO に関する情報を提供します。 (ANSI)
GROUP_POLICY_OBJECTW GROUP_POLICY_OBJECT構造は、GPO リスト内の GPO に関する情報を提供します。 (Unicode)
INSTALLDATA INSTALLDATA 構造体は、InstallApplication によってインストールされるグループ ポリシー アプリケーションを指定します。
INSTALLSPEC INSTALLSPEC 構造体は、わかりやすい名前とグループ ポリシー GUID、またはそのファイル名拡張子でグループ ポリシー アプリケーションを指定します。 INSTALLDATA 構造体の Spec メンバーは、この情報を InstallApplication 関数に提供します。
LOCALMANAGEDAPPLICATION LOCALMANAGEDAPPLICATION 構造体は、ユーザーまたはコンピューター用にインストールされたマネージド アプリケーションを表します。 GetLocalManagedApplications 関数によって返されます。
MANAGEDAPPLICATION MANAGEDAPPLICATION 構造体には、アプリケーションに関する情報が含まれています。 GetManagedApplications 関数は、MANAGEDAPPLICATION 構造体の配列を返します。
POLICYSETTINGSTATUSINFO POLICYSETTINGSTATUSINFO 構造体は、ポリシー設定イベントに関する情報を提供します。
RSOP_TARGET RSOP_TARGET構造体には、GenerateGroupPolicy 関数に必要なコンピューターとユーザーの情報が含まれています。