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 |