Metodo IGroupPolicyObject::SetOptions (gpedit.h)

Articolo
08/24/2023

Il metodo SetOptions imposta le opzioni per l'oggetto Criteri di gruppo.

Sintassi

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

Parametri

[in] dwOptions

Specifica i nuovi valori di opzione. Questo parametro può essere una o più delle opzioni seguenti. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

GPO_OPTION_DISABLE_USER

Disabilitare la parte utente dell'oggetto Criteri di gruppo.

GPO_OPTION_DISABLE_MACHINE

Disabilitare la parte computer dell'oggetto Criteri di gruppo.

[in] dwMask

Specifica le opzioni da modificare. Questo parametro può essere una o più delle opzioni seguenti. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

GPO_OPTION_DISABLE_USER

Disabilitare la parte utente dell'oggetto Criteri di gruppo.

GPO_OPTION_DISABLE_MACHINE

Disabilitare la parte computer dell'oggetto Criteri di gruppo.

Valore restituito

Se il metodo ha esito positivo, il valore restituito è S_OK. In caso contrario, il metodo restituisce uno dei codici di errore COM definiti nel file di intestazione di Platform SDK WinError.h.

Commenti

Nota Un aggiornamento dei criteri verrà attivato automaticamente quando la parte utente o computer dell'oggetto Criteri di gruppo locale è abilitata o disabilitata usando il metodo SetOptions.

Per modificare un'opzione, è necessario impostare il flag appropriato nel parametro dwMask . Se il flag è impostato, il sistema legge il parametro dwOptions per impostare il nuovo stato. Ad esempio, per disabilitare la parte utente di un oggetto Criteri di gruppo e lasciare invariata la parte computer, chiamare il metodo SetOptions come indicato di seguito:

SetOptions(GPO_OPTION_DISABLE_USER, GPO_OPTION_DISABLE_USER)

Per abilitare la parte utente e disabilitare la parte computer, chiamare il metodo SetOptions come indicato di seguito:

SetOptions(GPO_OPTION_DISABLE_MACHINE, GPO_OPTION_DISABLE_USER | GPO_OPTION_DISABLE_MACHINE)

Per recuperare le opzioni per un oggetto Criteri di gruppo, è possibile chiamare il metodo GetOptions .

Requisiti


Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	gpedit.h
DLL	Gpedit.dll