IGroupPolicyObject::New メソッド (gpedit.h)
New メソッドは、指定された表示名を持つ新しい GPO を Active Directory に作成します。 メソッドは、 OpenDSGPO メソッドを使用して GPO を開きます。
構文
HRESULT New(
[in] LPOLESTR pszDomainName,
[in] LPOLESTR pszDisplayName,
[in] DWORD dwFlags
);
パラメーター
[in] pszDomainName
作成するオブジェクトの Active Directory パスを指定します。 パスにドメイン コントローラーが指定されている場合は、その DC に GPO が作成されます。 それ以外の場合、システムは呼び出し元の代わりに DC を選択します。
[in] pszDisplayName
作成するオブジェクトの表示名を指定します。
[in] dwFlags
GPO のレジストリ情報を読み込むかどうかを指定します。 このパラメーターには、次の値のいずれかを指定できます。
GPO_OPEN_LOAD_REGISTRY
レジストリ情報を読み込みます。
GPO_OPEN_READ_ONLY
読み取り専用モードで GPO を開きます。
戻り値
メソッドが成功した場合、戻り値は S_OK。 それ以外の場合、メソッドは Platform SDK ヘッダー ファイル WinError.h で定義されている COM エラー コードのいずれかを返します。
注釈
既に存在する GPO を開くには、 OpenDSGPO メソッドを呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | gpedit.h |
| [DLL] | Gpedit.dll |