IFrequencyMap::put_CountryCode Method

Article
01/07/2009

The put_CountryCode method sets the country/region code on the Network Provider filter.

Syntax

HRESULT put_CountryCode(
  [in]  ULONG ulCountryCode
);

Parameters

ulCountryCode [in]
Specifies the country/region code.

Return Value

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

If the method succeeds, the Network Provider loads the frequency table for the specified country/region code. It uses this table in all subsequent calls to IScanningTuner methods.

If the country/region code does not match an existing frequency table, the method fails and the Network Provider continues to use the previous table. However, it stores the new country/region code, and the application can create a new frequency table by calling the put_FrequencyMapping method. This behavior enables an application to define new country/region codes with new frequency tables.

For a list of existing country/region codes, see Country/Region Assignments.

Requirements

Header

Declared in Bdaiface.h.

Share via