Fungsi WcmSetProperty (wcmapi.h)

Artikel
03/13/2024

Fungsi WcmSetProperty menetapkan nilai properti WCM.

Sintaks

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
);

Parameter

[in, optional] pInterface

Jenis: const GUID*

Antarmuka yang akan diatur. Untuk properti global, parameter ini adalah NULL.

[in, optional] strProfileName

Jenis: LPCWSTR

Nama profil.

[in] Property

Jenis: WCM_PROPERTY

Properti WCM yang akan diatur.

pReserved

Jenis: PVOID

Dicadangkan.

[in] dwDataSize

Jenis: DWORD

Ukuran nilai properti baru.

[in, optional] pbData

Jenis: const BYTE*

Nilai properti baru.

Mengembalikan nilai

Jenis: DWORD

Mengembalikan ERROR_SUCCESS jika berhasil, atau nilai kesalahan sebaliknya.

Keterangan

Jenis data yang disimpan dalam parameter pbData akan bervariasi, tergantung properti mana yang sedang diatur. Tabel ini memperlihatkan jenis data setiap properti.

Nama properti	Jenis data
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	String XML dengan panjang variabel. Lihat skema HotSpotProfile untuk informasi selengkapnya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	wcmapi.h
Pustaka	Wcmapi.lib
DLL	Wcmapi.dll

Lihat juga

Skema HotSpotProfile

WCM_PROPERTY

Bagikan melalui