IDefaultLocation::SetReport メソッド (locationapi.h)

[Win32 Location API は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、 Windows.Devices.Geolocation API を使用します。 ]

既定の場所を設定します。

構文

HRESULT SetReport(
  [in] REFIID          reportType,
  [in] ILocationReport *pLocationReport
);

パラメーター

[in] reportType

pLocationReport を使用して渡されるレポートの種類のインターフェイス ID を表す REFIID。

[in] pLocationReport

既定の場所プロバイダーからの場所レポートを含む ILocationReport インスタンスへのポインター。

戻り値

有効な値を次の表に示しますが、これ以外にもあります。

注釈

ILocationReport は、特定の場所レポートの種類の基本インターフェイスです。 pLocationReport に使用する実際のインターフェイスは、reportType で指定した型と一致する必要があります。

reportType で指定する型は、ICivicAddressReport または ILatLongReport の IID である必要があります。

緯度/経度レポートで提供される緯度と経度は、地球儀上の場所に対応している必要があります。 それ以外の場合、このメソッドは HRESULT エラー値を返します。

例

次の例は、シビック アドレス レポートを使用して既定の場所を設定する方法を示しています。

            // set the civic address fields of the Default Location
            hr = spDefaultLocation->SetReport(IID_ICivicAddressReport, spCivicAddressReport);
            if (E_INVALIDARG == hr)
            {
                wprintf(L"The civic address report has invalid data. ");
                wprintf(L"Country/region must be a valid ISO-3166 2-letter or 3-letter code.\n");
            }
            else if (E_ACCESSDENIED == hr)
            {
                wprintf(L"Administrator privilege required.\n");
            }

要件

こちらもご覧ください

IDefaultLocation