WcmQueryProperty-Funktion (wcmapi.h)
Die WcmQueryProperty-Funktion ruft den Wert einer angegebenen WCM-Eigenschaft ab.
Syntax
DWORD WcmQueryProperty(
[in, optional] const GUID *pInterface,
[in, optional] LPCWSTR strProfileName,
[in] WCM_PROPERTY Property,
void *pReserved,
[out] PDWORD pdwDataSize,
[out] PBYTE *ppData
);
Parameter
[in, optional] pInterface
Typ: const GUID*
Die abzufragende Schnittstelle. Für globale Eigenschaften ist dieser Parameter NULL.
[in, optional] strProfileName
Typ: LPCWSTR
Der Name des Profils. Beim Abfragen einer nicht globalen Eigenschaft (connection_cost, dataplan_status oder hotspot_profile) muss das Profil angegeben werden, andernfalls schlägt der Aufruf fehl.
[in] Property
Typ: WCM_PROPERTY
Die abzufragende WCM-Eigenschaft.
pReserved
Typ: PVOID
Reserviert.
[out] pdwDataSize
Typ: PDWORD
Die Größe des zurückgegebenen Eigenschaftswerts.
[out] ppData
Typ: PBYTE*
Der zurückgegebene Eigenschaftswert.
Rückgabewert
Art: DWORD
Gibt bei erfolgreicher Ausführung ERROR_SUCCESS oder andernfalls einen Fehlerwert zurück.
Hinweise
Der Typ der im ppData-Parameter gespeicherten Daten variiert je nachdem, welche Eigenschaft abgefragt wird. 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 | Enthält eine Ausgabe der Länge null. |
Anforderungen
| 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 |