Metodo ITAddressTranslation::get_Locations (tapi3if.h)

Il metodo get_Locations crea una raccolta di posizioni degli indirizzi attualmente disponibili. Questo metodo viene fornito per le applicazioni client di Automazione, ad esempio quelle scritte in Visual Basic. Le applicazioni C e C++ devono usare il metodo EnumerateLocations .

Sintassi

HRESULT get_Locations(
  [out] VARIANT *pVariant
);

Parametri

[out] pVariant

Puntatore a VARIANT contenente un puntatoreITLocationInfo (oggetti posizione).

Valore restituito

Questo metodo può restituire uno di questi valori.

valore	Significato
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro pVariant non è un puntatore valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.

Commenti

Il metodo get_Locations è un wrapper COM per la funzione LINEGetTranslateCaps 2.1 e accetta informazioni sulla posizione dalla struttura LINETRANSLATECAPS restituita da tale funzione.

TAPI chiama il metodo AddRef nell'interfaccia ITLocationInfo restituita da ITAddressTranslation::get_Locations. L'applicazione deve chiamare Release nell'interfaccia ITLocationInfo per liberare risorse associate.

Requisiti

Piattaforma di destinazione	Windows
Intestazione	tapi3if.h (includere Tapi3.h)
Libreria	Uuid.lib
DLL	Tapi3.dll

Vedi anche

Oggetto Address

EnumerateLocations

ITAddressTranslation

ITCollection

ITLocationInfo