Compartir a través de


estructura de 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 GUIDagrupada entre corchetes. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

lParam2

Datos proporcionados por el usuario.

lpLink

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

Comentarios

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 de 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 GUIDque identifican las extensiones de complemento que tienen datos almacenados en el GPO. Después del último GUID de complemento 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Encabezado userenv.h

Consulte también

FreeGPOList

GetGPOList

Introducción a las directivas de grupo

Estructuras de directiva de grupo