Compartir a través de


estructura GROUP_POLICY_OBJECTW (userenv.h)

La estructura GROUP_POLICY_OBJECT proporciona información sobre un GPO en una lista de GPO.

Sintaxis

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;

Miembros

dwOptions

Especifica las opciones de vínculo. Este miembro puede ser uno de los siguientes valores.

GPO_FLAG_DISABLE

Este GPO está deshabilitado.

GPO_FLAG_FORCE

No invalide la configuración de directiva en este GPO con la configuración de directiva en un GPO posterior.

dwVersion

Especifica el número de versión del GPO.

lpDSPath

Puntero a una cadena que especifica la ruta de acceso a la parte del servicio de directorio del GPO.

lpFileSysPath

Puntero a una cadena que especifica la ruta de acceso a la parte del sistema de archivos del GPO.

lpDisplayName

Puntero al nombre para mostrar del GPO.

szGPOName[50]

Puntero a una cadena que especifica un nombre único que identifica el GPO.

GPOLink

Especifica la información de vínculo del GPO. Este miembro puede ser uno de los siguientes valores.

GPLinkUnknown

No hay información de vínculo disponible.

GPLinkMachine

El GPO está vinculado a un equipo (local o remoto).

GPLinkSite

El GPO está vinculado a un sitio.

GPLinkDomain

El GPO está vinculado a un dominio.

GPLinkOrganizationalUnit

El GPO está vinculado a una unidad organizativa.

lParam

Datos proporcionados por el usuario.

pNext

Puntero al siguiente GPO de la lista.

pPrev

Puntero al GPO anterior de la lista.

lpExtensions

Extensiones que tienen datos almacenados en este GPO. El formato es una cadena de GUIDagrupados entre corchetes. Para obtener más información, vea la siguiente sección Comentarios.

lParam2

Datos proporcionados por el usuario.

lpLink

Ruta de acceso al sitio, dominio o unidad de organización de Active Directory al que está vinculado este GPO. Si el GPO está vinculado al GPO local, este miembro es "Local".

Observaciones

Cada GPO podría contener datos que deben procesar varias extensiones de complemento. Por lo tanto, los datos del miembro lpExtensions se organizan como una serie de GUIDque identifican las extensiones y las extensiones del complemento. El formato de datos es el siguiente:

[ext_guid1, snap_in_guid1, snap_in_guid2, ...] 
[ext_guid2, snap_in_guid3, snap_in_guid4, ...] 

En primer lugar, hay un corchete de apertura"[", seguido del GUID de la extensión. A continuación, encontrará uno o varios GUIDidentificar las extensiones de complemento que tienen datos almacenados en el GPO. Después del último complemento GUID para una extensión, hay un corchete de cierre, "]". Este patrón se repite para la siguiente extensión.

Nota

El encabezado userenv.h define GROUP_POLICY_OBJECT como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows Vista
servidor mínimo admitido Windows Server 2008
encabezado de userenv.h

Consulte también

FreeGPOList de

GetGPOList

de información general de la directiva de grupo de

estructuras de directiva de grupo de