wcmSetProperty 函式 (wcmapi.h)

WcmSetProperty 函式會設定 WCM 屬性的值。

語法

DWORD WcmSetProperty(
  [in, optional] const GUID   *pInterface,
  [in, optional] LPCWSTR      strProfileName,
  [in]           WCM_PROPERTY Property,
                 void         *pReserved,
  [in]           DWORD        dwDataSize,
  [in, optional] const BYTE   *pbData
);

參數

[in, optional] pInterface

類型： const GUID*

要設定的介面。 針對全域屬性，此參數為 NULL。

[in, optional] strProfileName

類型： LPCWSTR

設定檔名稱。

[in] Property

類型： WCM_PROPERTY

要設定的 WCM 屬性。

pReserved

類型： PVOID

保留的。

[in] dwDataSize

類型： DWORD

新屬性值的大小。

[in, optional] pbData

類型： const BYTE*

新的屬性值。

傳回值

類型： DWORD

如果成功，則傳回ERROR_SUCCESS，否則傳回錯誤值。

備註

儲存在 pbData 參數中的數據類型會根據所設定的屬性而有所不同。 下表顯示每個屬性的數據類型。

屬性名稱	資料類型
wcm_global_property_domain_policy	WCM_POLICY_VALUE
wcm_global_property_minimize_policy	WCM_POLICY_VALUE
wcm_global_property_roaming_policy	WCM_POLICY_VALUE
wcm_global_property_powermanagement_policy	WCM_POLICY_VALUE
wcm_intf_property_connection_cost	WCM_CONNECTION_COST_DATA
wcm_intf_property_dataplan_status	WCM_DATAPLAN_STATUS
wcm_intf_property_hotspot_profile	可變長度 XML 字串。 如需詳細資訊，請參閱 HotSpotProfile 架構 。

規格需求

需求	值
最低支援的用戶端	Windows 8 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2012 [僅限傳統型應用程式]
目標平台	Windows
標頭	wcmapi.h
程式庫	Wcmapi.lib
Dll	Wcmapi.dll

另請參閱

HotSpotProfile 架構

WCM_PROPERTY