estrutura GROUP_POLICY_OBJECTA (userenv.h)
A estrutura GROUP_POLICY_OBJECT fornece informações sobre um GPO em uma lista de GPO.
Sintaxe
typedef struct _GROUP_POLICY_OBJECTA {
DWORD dwOptions;
DWORD dwVersion;
LPSTR lpDSPath;
LPSTR lpFileSysPath;
LPSTR lpDisplayName;
CHAR szGPOName[50];
GPO_LINK GPOLink;
LPARAM lParam;
struct _GROUP_POLICY_OBJECTA *pNext;
struct _GROUP_POLICY_OBJECTA *pPrev;
LPSTR lpExtensions;
LPARAM lParam2;
LPSTR lpLink;
} GROUP_POLICY_OBJECTA, *PGROUP_POLICY_OBJECTA;
Membros
dwOptions
Especifica as opções de link. Esse membro pode ser um dos seguintes valores.
GPO_FLAG_DISABLE
Esse GPO está desabilitado.
GPO_FLAG_FORCE
Não substitua as configurações de política neste GPO com 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 de 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 seguintes valores.
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 armazenaram dados neste GPO. O formato é uma cadeia de caracteres de GUIDagrupados 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 da organização à qual esse GPO está vinculado. Se o GPO estiver vinculado ao GPO local, esse membro será "Local".
Observações
Cada GPO pode conter dados que devem ser processados por várias extensões de snap-in. Portanto, os dados no membro lpExtensions
[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á uma ou mais GUIDidentificar as extensões de snap-in que armazenaram dados no GPO. Após o último snap-in GUID para uma extensão, há um colchete de fechamento, "]". Esse padrão é repetido para a próxima extensão.
Nota
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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows Vista |
| servidor com suporte mínimo | Windows Server 2008 |
| cabeçalho | userenv.h |