WcmSetProperty-Funktion (wcmapi.h)

Artikel
03/06/2024

Die WcmSetProperty-Funktion legt den Wert einer WCM-Eigenschaft fest.

Syntax

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

Typ: const GUID*

Die festzulegende Schnittstelle. Für globale Eigenschaften ist dieser Parameter NULL.

[in, optional] strProfileName

Typ: LPCWSTR

Der Profilname.

[in] Property

Typ: WCM_PROPERTY

Die festzulegende WCM-Eigenschaft.

pReserved

Typ: PVOID

Reserviert.

[in] dwDataSize

Art: DWORD

Die Größe des neuen Eigenschaftswerts.

[in, optional] pbData

Typ: const BYTE*

Der neue Eigenschaftswert.

Rückgabewert

Art: DWORD

Gibt bei erfolgreicher Ausführung ERROR_SUCCESS oder andernfalls einen Fehlerwert zurück.

Hinweise

Der Typ der im pbData-Parameter gespeicherten Daten variiert je nach festgelegter Eigenschaft. In dieser Tabelle wird der Datentyp der einzelnen Eigenschaften angezeigt.

Eigenschaftenname	Datentyp
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-Zeichenfolge mit variabler Länge. Weitere Informationen finden Sie im HotSpotProfile-Schema .

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wcmapi.h
Bibliothek	wcmapi.lib
DLL	Wcmapi.dll

Weitere Informationen

HotSpotProfile-Schema

WCM_PROPERTY

Freigeben über