共用方式為


IGroupPolicyObject::SetOptions 方法 (gpedit.h)

SetOptions方法會設定 GPO 的選項。

語法

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

參數

[in] dwOptions

指定新的選項值。 此參數可以是下列一或多個選項。 如需詳細資訊,請參閱接下來的<備註>一節。

GPO_OPTION_DISABLE_USER

停用 GPO 的使用者部分。

GPO_OPTION_DISABLE_MACHINE

停用 GPO 的電腦部分。

[in] dwMask

指定要變更的選項。 此參數可以是下列一或多個選項。 如需詳細資訊,請參閱接下來的<備註>一節。

GPO_OPTION_DISABLE_USER

停用 GPO 的使用者部分。

GPO_OPTION_DISABLE_MACHINE

停用 GPO 的電腦部分。

傳回值

如果方法成功,傳回值 會S_OK。 否則,方法會傳回 Platform SDK 標頭檔 WinError.h 中定義的其中一個 COM 錯誤碼。

備註

注意使用SetOptions方法啟用或停用本機群組原則物件的使用者或電腦部分時,系統會自動觸發原則重新整理。
 
若要變更選項,您必須在 dwMask 參數中設定適當的旗標。 如果設定旗標,則系統會讀取 dwOptions 參數來設定新狀態。 例如,若要停用 GPO 的使用者部分,並將電腦部分保留不變,請呼叫 SetOptions 方法,如下所示:
SetOptions(GPO_OPTION_DISABLE_USER, GPO_OPTION_DISABLE_USER)

若要啟用使用者部分並停用電腦部分,請呼叫 SetOptions 方法,如下所示:

SetOptions(GPO_OPTION_DISABLE_MACHINE, GPO_OPTION_DISABLE_USER | GPO_OPTION_DISABLE_MACHINE)

若要擷取 GPO 的選項,您可以呼叫 GetOptions 方法。

需求

   
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 gpedit.h
Dll Gpedit.dll

另請參閱

GetOptions

群組原則介面

群組原則概觀

IGroupPolicyObject