ITCollection::get__NewEnum-Methode (tapi3if.h)
Die get__NewEnum-Methode ruft einen Enumerator für die Auflistung ab.
Syntax
HRESULT get__NewEnum(
[out] IUnknown **ppNewEnum
);
Parameter
[out] ppNewEnum
Zeiger auf eine IUnknown-Schnittstelle für ein Enumeratorobjekt für die Auflistung.
Rufen Sie die QueryInterface-Methode für die zurückgegebene IUnknown-Schnittstelle auf, um einen Zeiger auf eine IEnumVARIANT-Enumerationsschnittstelle für die Auflistung abzurufen. IEnumVARIANT stellt eine Reihe von Methoden bereit, mit denen Sie die Auflistung durchlaufen können.
Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Methode war erfolgreich. |
|
Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden. |
Hinweise
Jede TAPI 3-Schnittstelle, die eine Methode enthält, die eine Auflistung zurückgibt, enthält auch eine Methode, die einen Zeiger auf eine TAPI 3-Enumeratorschnittstelle zurückgibt. Wenn Sie in C/C++ programmieren, kann es einfacher sein, die Enumeratormethode einer Auflistung direkt aufzurufen, um ein Enumeratorobjekt abzurufen, anstatt die ITCollection::get__NewEnum-Methode aufzurufen. Beispielsweise gibt die ITTAPI::EnumerateAddresses-Methode einen Zeiger auf eine IEnumAddress-Schnittstelle zurück. IEnumAddress stellt Enumerationsmethoden für das Address-Objekt bereit.
Wenn Sie in Visual Basic programmieren, müssen Sie diese Methode nicht aufrufen, um eine Auflistung aufzulisten. Dies liegt daran, dass Sie die Funktionalität der Methode implizit aufrufen können, indem Sie for... Jeder... In... Nächster... Erstellen.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (einschließlich Tapi3.h) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |