GROUP_POLICY_OBJECT structure
The GROUP_POLICY_OBJECT structure provides information about a GPO in a GPO list.
Syntax
typedef struct _GROUP_POLICY_OBJECT { DWORD dwOptions; DWORD dwVersion; LPCTSTR lpDSPath; LPCTSTR lpFileSysPath; LPCTSTR lpDisplayName; TCHAR szGPOName[50]; GPO_LINK GPOLink; LPARAM lParam; struct _GROUP_POLICY_OBJECT *pNext; struct _GROUP_POLICY_OBJECT *pPrev; LPTSTR lpExtensions; LPARAM lParam2; LPTSTR lpLink; } GROUP_POLICY_OBJECT, *PGROUP_POLICY_OBJECT;
Members
- dwOptions
-
Specifies link options. This member can be one of the following values.
- dwVersion
-
Specifies the version number of the GPO.
- lpDSPath
-
Pointer to a string that specifies the path to the directory service portion of the GPO.
- lpFileSysPath
-
Pointer to a string that specifies the path to the file system portion of the GPO.
- lpDisplayName
-
Pointer to the display name of the GPO.
- szGPOName
-
Pointer to a string that specifies a unique name that identifies the GPO.
- GPOLink
-
Specifies the link information for the GPO. This member may be one of the following values.
- lParam
-
User-supplied data.
- pNext
-
Pointer to the next GPO in the list.
- pPrev
-
Pointer to the previous GPO in the list.
- lpExtensions
-
Extensions that have stored data in this GPO. The format is a string of GUIDs grouped in brackets. For more information, see the following Remarks section.
- lParam2
-
User-supplied data.
- lpLink
-
Path to the Active Directory site, domain, or organization unit to which this GPO is linked. If the GPO is linked to the local GPO, this member is "Local".
Remarks
Each GPO could contain data that must be processed by multiple snap-in extensions. Therefore, the data in the lpExtensions member is organized as a series of GUIDs that identify the extensions and snap-in extensions. The data format is as follows:
[ext_guid1, snap_in_guid1, snap_in_guid2, ...] [ext_guid2, snap_in_guid3, snap_in_guid4, ...]
First, there is an opening bracket, "[", followed by the GUID of the extension. Next, you'll find one or more GUIDs identifying the snap-in extensions that have stored data in the GPO. After the last snap-in GUID for an extension, there is a closing bracket, "]". This pattern is repeated for the next extension.
Requirements
|
Minimum supported client |
Windows Vista |
|---|---|
|
Minimum supported server |
Windows Server 2008 |
|
Header |
|
|
Unicode and ANSI names |
GROUP_POLICY_OBJECTW (Unicode) and GROUP_POLICY_OBJECTA (ANSI) |
See also