IDefaultLocation

IDefaultLocation は、既定の位置(ロケーション)を指定または取得するためのメソッドを提供します。

既定の位置を設定します。

取り得る値には、次の表に示すものが含まれますが、これらに限定されません。

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");
            }

既定の位置プロバイダーから、指定したレポートの種類を取得します。

このメソッドは HRESULT を返します。取り得る値には、次の表に示すものが含まれますが、これらに限定されません。

ILocationReport は、特定の位置レポートの種類の基底インターフェースです。ppLocationReport に使用する実際のインターフェースは、reportType で指定した種類と一致している必要があります。

IDefaultLocation::GetReport の呼び出しがアプリケーションによる位置情報の初回使用である場合、タスクバーに通知が表示され、イベントビューアーに位置情報アクティビティのイベントが記録されることがあります。