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 |
|---|---|
|
Il metodo è riuscito. |
|
Il parametro ppEnumLocations non è un puntatore valido. |
|
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 |