GROUP_POLICY_OBJECTA結構 (userenv.h)

發行項
03/03/2024

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

另請參閱

共用方式為