estrutura GROUP_POLICY_OBJECTW (userenv.h)
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 |