GROUP_POLICY_OBJECTA結構 (userenv.h)
GROUP_POLICY_OBJECT 結構會提供 GPO 清單中 GPO 的相關信息。
語法
typedef struct _GROUP_POLICY_OBJECTA {
DWORD dwOptions;
DWORD dwVersion;
LPSTR lpDSPath;
LPSTR lpFileSysPath;
LPSTR lpDisplayName;
CHAR szGPOName[50];
GPO_LINK GPOLink;
LPARAM lParam;
struct _GROUP_POLICY_OBJECTA *pNext;
struct _GROUP_POLICY_OBJECTA *pPrev;
LPSTR lpExtensions;
LPARAM lParam2;
LPSTR lpLink;
} GROUP_POLICY_OBJECTA, *PGROUP_POLICY_OBJECTA;
成員
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,則此成員為「本機」。
言論
每個 GPO 都可以包含必須由多個嵌入式管理單元延伸模組處理的數據。 因此,lpExtensions 成員中的數據會組織成一系列的 GUID,以識別擴充功能和嵌入式管理單元擴充功能。 資料格式如下所示:
[ext_guid1, snap_in_guid1, snap_in_guid2, ...]
[ext_guid2, snap_in_guid3, snap_in_guid4, ...]
首先,有左括弧 “[”,後面接著延伸模組的 GUID。 接下來,您會發現一或多個 GUID識別儲存在 GPO 中數據的嵌入式管理單元延伸模組。 在延伸模組的最後一個嵌入式管理單元 GUID 之後,會有右括弧 “]”。 下一個延伸模組會重複此模式。
注意
userenv.h 標頭會將GROUP_POLICY_OBJECT定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱函式原型的
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista |
支援的最低伺服器 | Windows Server 2008 |
標頭 | userenv.h |