Metodo ITAddressTranslation::EnumerateLocations (tapi3if.h)

Il metodo EnumerateLocations enumera i percorsi degli indirizzi attualmente disponibili. Questo metodo viene fornito per le applicazioni C e C++. Le applicazioni client di automazione, ad esempio quelle scritte in Visual Basic, devono usare il metodo get_Locations .

Sintassi

HRESULT EnumerateLocations(
  [out] IEnumLocation **ppEnumLocation
);

Parametri

[out] ppEnumLocation

Puntatore all'oggetto IEnumLocation creato.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro ppEnumLocations non è un puntatore valido.
E_OUTOFMEMORY	Memoria insufficiente per la creazione di un oggetto.

Commenti

Il metodo EnumerateLocations è un wrapper COM per la funzione LineGetTranslateCaps TAPI 2.1 e accetta le informazioni sulla posizione dalla struttura LINETRANSLATECAPS restituita da tale funzione.

TAPI chiama il metodo AddRef sull'interfaccia IEnumLocation restituita da ITAddressTranslation::EnumerateLocations. L'applicazione deve chiamare Release nell'interfaccia IEnumLocation per liberare le risorse associate.

Requisiti

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

Vedi anche

Oggetto Address

IEnumLocation

ITAddressTranslation