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 | 길이가 0인 출력을 포함합니다. |
요구 사항
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | wcmapi.h |
| 라이브러리 | Wcmapi.lib |
| DLL | Wcmapi.dll |