ILocationReport

位置レポートの親インターフェースです。

位置レポートを生成したセンサーの ID を取得します。

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

センサー ID は GUID です。

例

次の例は GetSensorID を呼び出す方法を示しています。

    // センサー ID の GUID を出力する
    GUID sensorID = {0};
    if (SUCCEEDED(spLatLongReport->GetSensorID(&sensorID)))
    {
        wprintf(L"SensorID: %s\n", GUIDToString(sensorID, szGUID, ARRAYSIZE(szGUID)));
    }

レポートが生成された日時を取得します。

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

位置レポートからプロパティ値を取得します。

このメソッドが成功すると S_OK を返します。それ以外の場合は HRESULT エラーコードを返します。

プロパティはプラットフォームで定義される場合と、製造元で定義される場合があります。

位置センサー向けのプラットフォーム定義の PROPERTYKEY 値は、sensors.h の位置センサーデータ型セクションで定義されています。

次の表は、位置レポートに一般的に関連付けられる、プラットフォーム定義のプロパティの一部を示しています。これらのプロパティキーは、fmtid フィールドが SENSOR_DATA_TYPE_LOCATION_GUID と等しくなります。追加のプロパティは sensors.h で確認できます。SetReport に渡す独自の位置レポートを実装する場合、この表は、レポートオブジェクトの GetValue の実装でどの値を提供する必要があるかを示しています。

次の表は、位置レポートに現れる可能性があるものの、位置に固有ではない、その他のプラットフォーム定義のプロパティを示しています。これらのプロパティキーの fmtid フィールドは SENSOR_PROPERTY_COMMON_GUID です。

例

次の例は、プロパティ値を取得するために GetValue を呼び出す方法を示しています。この例の定数を使用するには sensors.h をインクルードする必要があります。

PROPVARIANT pv;				
HRESULT hr = spLatLongReport->GetValue(SENSOR_DATA_TYPE_LATITUDE_DEGREES, &pv);

次の例は、独自のレポートオブジェクトで GetValue を実装する方法を示しています。この実装により、呼び出し元はいくつかの位置レポートフィールドの値を取得できます。このコードでは sensors.h と provarutil.h をインクルードする必要があります。

STDMETHODIMP CLocationReport::GetValue(REFPROPERTYKEY pKey, PROPVARIANT *pValue)
{
    HRESULT hr = S_OK;

    if (pKey.fmtid == SENSOR_DATA_TYPE_LOCATION_GUID) 
    {
        // 市街地住所レポートのプロパティ
        if (pKey.pid == SENSOR_DATA_TYPE_ADDRESS1.pid)
        {
            hr = InitPropVariantFromString(m_address1, pValue);
        } 
        else if (pKey.pid == SENSOR_DATA_TYPE_ADDRESS2.pid)
        {    
            hr = InitPropVariantFromString(m_address2, pValue);
        }
        else if (pKey.pid == SENSOR_DATA_TYPE_CITY.pid)
        {
            hr = InitPropVariantFromString(m_city, pValue);
        }
        else if (pKey.pid == SENSOR_DATA_TYPE_STATE_PROVINCE.pid)
        {
            hr = InitPropVariantFromString(m_stateprovince, pValue);
        } 
        else if (pKey.pid == SENSOR_DATA_TYPE_POSTALCODE.pid)
        {
            hr = InitPropVariantFromString(m_postalcode, pValue);
        }
        else if (pKey.pid == SENSOR_DATA_TYPE_COUNTRY_REGION.pid)    
        {
            hr = InitPropVariantFromString(m_countryregion, pValue);
        }
        // 緯度/経度レポートのプロパティ
        else if (pKey.pid == SENSOR_DATA_TYPE_LATITUDE_DEGREES.pid)
        {
            hr = InitPropVariantFromDouble(m_latitude, pValue);
        } 
        else if (pKey.pid == SENSOR_DATA_TYPE_LONGITUDE_DEGREES.pid)
        {
            hr = InitPropVariantFromDouble(m_longitude, pValue);
        }
        else if (pKey.pid == SENSOR_DATA_TYPE_ERROR_RADIUS_METERS.pid)    
        {
            hr = InitPropVariantFromDouble(m_errorradius, pValue);
        }
        else 
        {
            hr = HRESULT_FROM_WIN32(ERROR_NO_DATA);
            PropVariantInit(pValue);
        }
    }
    return hr;
}