Compartilhar via

estrutura GROUP_POLICY_OBJECTW (userenv.h)

  • Artigo

A estrutura GROUP_POLICY_OBJECT fornece informações sobre um GPO em uma lista de GPO.

Sintaxe

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;

Membros

dwOptions

Especifica as opções de link. Esse membro pode ser um dos valores a seguir.

GPO_FLAG_DISABLE

Esse GPO está desabilitado.

GPO_FLAG_FORCE

Não substitua as configurações de política neste GPO com as configurações de política em um GPO subsequente.

dwVersion

Especifica o número de versão do GPO.

lpDSPath

Ponteiro para uma cadeia de caracteres que especifica o caminho para a parte do serviço de diretório do GPO.

lpFileSysPath

Ponteiro para uma cadeia de caracteres que especifica o caminho para a parte do sistema de arquivos do GPO.

lpDisplayName

Ponteiro para o nome de exibição do GPO.

szGPOName[50]

Ponteiro para uma cadeia de caracteres que especifica um nome exclusivo que identifica o GPO.

GPOLink

Especifica as informações de link para o GPO. Esse membro pode ser um dos valores a seguir.

GPLinkUnknown

Nenhuma informação de link está disponível.

GPLinkMachine

O GPO está vinculado a um computador (local ou remoto).

GPLinkSite

O GPO está vinculado a um site.

GPLinkDomain

O GPO está vinculado a um domínio.

GPLinkOrganizationalUnit

O GPO está vinculado a uma unidade organizacional.

lParam

Dados fornecidos pelo usuário.

pNext

Ponteiro para o próximo GPO na lista.

pPrev

Ponteiro para o GPO anterior na lista.

lpExtensions

Extensões que têm dados armazenados neste GPO. O formato é uma cadeia de caracteres de GUIDagrupada entre colchetes. Para obter mais informações, consulte a seção Comentários a seguir.

lParam2

Dados fornecidos pelo usuário.

lpLink

Caminho para o site do Active Directory, domínio ou unidade organizacional à qual esse GPO está vinculado. Se o GPO estiver vinculado ao GPO local, esse membro será "Local".

Comentários

Cada GPO pode conter dados que devem ser processados por várias extensões de snap-in. Portanto, os dados no membro lpExtensions são organizados como uma série de GUIDs que identificam as extensões e extensões de snap-in. O formato de dados é o seguinte:

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

Primeiro, há um colchete de abertura, "[", seguido pelo GUID da extensão. Em seguida, você encontrará um ou mais GUIDsidentificando as extensões de snap-in que armazenaram dados no GPO. Após o último GUID de snap-in de uma extensão, há um colchete de fechamento, "]". Esse padrão é repetido para a próxima extensão.

Observação

O cabeçalho userenv.h define GROUP_POLICY_OBJECT como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Cabeçalho userenv.h

Confira também

FreeGPOList

GetGPOList

Visão geral da Política de Grupo

Estruturas de Política de Grupo