GROUP_POLICY_OBJECTW結構 (userenv.h)

發行項
08/26/2023

GROUP_POLICY_OBJECT結構提供 GPO 清單中 GPO 的相關資訊。

語法

typedef struct _GROUP_POLICY_OBJECTW {
  DWORD                        dwOptions;
  DWORD                        dwVersion;
  LPWSTR                       lpDSPath;
  LPWSTR                       lpFileSysPath;
  LPWSTR                       lpDisplayName;
  WCHAR                        szGPOName[50];
  GPO_LINK                     GPOLink;
  LPARAM                       lParam;
  struct _GROUP_POLICY_OBJECTW *pNext;
  struct _GROUP_POLICY_OBJECTW *pPrev;
  LPWSTR                       lpExtensions;
  LPARAM                       lParam2;
  LPWSTR                       lpLink;
} GROUP_POLICY_OBJECTW, *PGROUP_POLICY_OBJECTW;

成員

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

另請參閱

共用方式為