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

Artículo
08/24/2023

El método SetOptions establece las opciones del GPO.

Sintaxis

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

Parámetros

[in] dwOptions

Especifica los nuevos valores de opción. Este parámetro puede ser una o varias de las siguientes opciones. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

GPO_OPTION_DISABLE_USER

Deshabilite la parte del usuario del GPO.

GPO_OPTION_DISABLE_MACHINE

Deshabilite la parte del equipo del GPO.

[in] dwMask

Especifica las opciones que se van a cambiar. Este parámetro puede ser una o varias de las siguientes opciones. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

GPO_OPTION_DISABLE_USER

Deshabilite la parte del usuario del GPO.

GPO_OPTION_DISABLE_MACHINE

Deshabilite la parte del equipo del GPO.

Valor devuelto

Si el método se realiza correctamente, el valor devuelto se S_OK. De lo contrario, el método devuelve uno de los códigos de error COM definidos en el archivo de encabezado winError.h del SDK de plataforma.

Comentarios

Nota Una actualización de directiva se desencadenará automáticamente cuando el usuario o la parte del equipo del objeto local directiva de grupo esté habilitado o deshabilitado mediante el método SetOptions.

Para cambiar una opción, debe establecer la marca adecuada en el parámetro dwMask . Si se establece la marca, el sistema lee el parámetro dwOptions para establecer el nuevo estado. Por ejemplo, para deshabilitar la parte del usuario de un GPO y dejar la parte del equipo sin cambios, llame al método SetOptions de la siguiente manera:

SetOptions(GPO_OPTION_DISABLE_USER, GPO_OPTION_DISABLE_USER)

Para habilitar la parte del usuario y deshabilitar la parte del equipo, llame al método SetOptions de la siguiente manera:

SetOptions(GPO_OPTION_DISABLE_MACHINE, GPO_OPTION_DISABLE_USER | GPO_OPTION_DISABLE_MACHINE)

Para recuperar las opciones de un GPO, puede llamar al método GetOptions .

Requisitos


Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	gpedit.h
Archivo DLL	Gpedit.dll