IGroupPolicyObject::GetDSPath メソッド (gpedit.h)
GetDSPath メソッドは、指定した GPO セクションのルートへの Active Directory パスを取得します。
構文
HRESULT GetDSPath(
[in] DWORD dwSection,
[out] LPOLESTR pszPath,
[in] int cchMaxPath
);
パラメーター
[in] dwSection
GPO セクションを指定します。 このパラメーターには、次の値のいずれかを指定できます。
GPO_SECTION_ROOT
ルート セクション
GPO_SECTION_USER
ユーザー セクション
GPO_SECTION_MACHINE
[コンピューター] セクション
[out] pszPath
ADSI 形式でパスを受け取るバッファーへのポインター (LDAP://cn=user、ou=users、dc=coname、dc=com)。
[in] cchMaxPath
pszPath バッファーに格納できる最大文字数を指定します。
戻り値
メソッドが成功した場合、戻り値は S_OK。 それ以外の場合、メソッドは Platform SDK ヘッダー ファイル WinError.h で定義されている COM エラー コードのいずれかを返します。
解説
GetDSPath メソッドを呼び出してコンピューター GPO を指定すると、メソッドは成功しますが、返された場合、pszPath パラメーターには空の文字列が含まれます。 これは、コンピューター GPO に Active Directory ストレージがないためです。ファイル システム ストレージのみが含まれます。
GPO セクションのルートへのファイル システム パスを取得するには、 GetFileSysPath メソッドを呼び出します。
要件
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | gpedit.h |
| [DLL] | Gpedit.dll |