wcmQueryProperty 函式 (wcmapi.h)
WcmQueryProperty 函式會擷取指定 WCM 屬性的值。
語法
DWORD WcmQueryProperty(
[in, optional] const GUID *pInterface,
[in, optional] LPCWSTR strProfileName,
[in] WCM_PROPERTY Property,
void *pReserved,
[out] PDWORD pdwDataSize,
[out] PBYTE *ppData
);
參數
[in, optional] pInterface
類型： const GUID*
要查詢的介面。 針對全域屬性，此參數為 Null。
[in, optional] strProfileName
類型： LPCWSTR
設定檔的名稱。 如果查詢非全域屬性 (connection_cost、 dataplan_status或hotspot_profile ) ，則必須指定設定檔，否則呼叫將會失敗。
[in] Property
類型： WCM_PROPERTY
要查詢的 WCM 屬性。
pReserved
類型： PVOID
保留的。
[out] pdwDataSize
類型： PDWORD
傳回屬性值的大小。
[out] ppData
類型： PBYTE*
傳回的屬性值。
傳回值
類型： DWORD
如果成功，則傳回ERROR_SUCCESS，否則傳回錯誤值。
備註
儲存在 ppData 參數中的資料類型會根據要查詢的屬性而有所不同。 下表顯示每個屬性的資料類型。
| 屬性名稱 | 資料類型 |
|---|---|
| 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 | 包含長度為零的輸出。 |
規格需求
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | wcmapi.h |
| 程式庫 | Wcmapi.lib |
| Dll | Wcmapi.dll |