Método IGroupPolicyObject::SetOptions (gpedit.h)

Artigo
08/24/2023

O método SetOptions define as opções para o GPO.

Sintaxe

HRESULT SetOptions(
  [in] DWORD dwOptions,
  [in] DWORD dwMask
);

Parâmetros

[in] dwOptions

Especifica os novos valores de opção. Esse parâmetro pode ser uma ou mais das opções a seguir. Para obter mais informações, consulte a seção Comentários a seguir.

GPO_OPTION_DISABLE_USER

Desabilite a parte do usuário do GPO.

GPO_OPTION_DISABLE_MACHINE

Desabilite a parte do computador do GPO.

[in] dwMask

Especifica as opções a serem alteradas. Esse parâmetro pode ser uma ou mais das opções a seguir. Para obter mais informações, consulte a seção Comentários a seguir.

GPO_OPTION_DISABLE_USER

Desabilite a parte do usuário do GPO.

GPO_OPTION_DISABLE_MACHINE

Desabilite a parte do computador do GPO.

Valor retornado

Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, o método retornará um dos códigos de erro COM definidos no arquivo de cabeçalho do SDK da Plataforma WinError.h.

Comentários

Nota Uma atualização de política será disparada automaticamente quando a parte do usuário ou computador do objeto Política de Grupo local estiver habilitada ou desabilitada usando o método SetOptions.

Para alterar uma opção, você deve definir o sinalizador apropriado no parâmetro dwMask . Se o sinalizador estiver definido, o sistema lerá o parâmetro dwOptions para definir o novo estado. Por exemplo, para desabilitar a parte do usuário de um GPO e deixar a parte do computador inalterada, chame o método SetOptions da seguinte maneira:

SetOptions(GPO_OPTION_DISABLE_USER, GPO_OPTION_DISABLE_USER)

Para habilitar a parte do usuário e desabilitar a parte do computador, chame o método SetOptions da seguinte maneira:

SetOptions(GPO_OPTION_DISABLE_MACHINE, GPO_OPTION_DISABLE_USER | GPO_OPTION_DISABLE_MACHINE)

Para recuperar as opções de um GPO, você pode chamar o método GetOptions .

Requisitos


Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	gpedit.h
DLL	Gpedit.dll