Platform SDK: TAPI

ITAddressTranslation::get_Locations

Creates a collection of currently available address locations. This method is provided for Automation client applications, such as those written in Visual Basic. C and C++ applications must use the EnumerateLocations method.

HRESULT get_Locations(
  VARIANT *pVariant
);

Parameters

pVariant
[out, retval] Pointer to VARIANT containing an ITCollection of ITLocationInfo interface pointers (location objects).

Return Values

Value Meaning
S_OK Method succeeded.
E_POINTER The pVariant parameter is not a valid pointer.
E_OUTOFMEMORY Insufficient memory exists to perform the operation.

Remarks

The get_Locations method is a COM wrapper for the TAPI 2.1 LineGetTranslateCaps function, and takes location information from the LINETRANSLATECAPS structure returned by that function.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Version: Requires TAPI 3.0 or later.
  Header: Declared in Tapi3.h.
  Library: Use T3iid.lib.

See Also

ITAddressTranslation, EnumerateLocations, Address Object, ITCollection, ITLocationInfo