Freigeben über


IStringTable::Enumerate-Methode (mmc.h)

Die IStringTable::Enumerate-Methode stellt einen Zeiger auf eine IEnumString-Schnittstelle auf einem Enumerator bereit, der die Zeichenfolgen in der Zeichenfolgentabelle eines Snap-Ins zurückgeben kann. Die IEnumString-Schnittstelle ist eine COM-Standardschnittstelle.

Syntax

HRESULT Enumerate(
  [out] IEnumString **ppEnum
);

Parameter

[out] ppEnum

Die Adresse der IEnumString*-Zeigervariable, die den Schnittstellenzeiger auf den Enumerator empfängt. Wenn ein Fehler auftritt, wird *ppEnum auf NULL festgelegt. Wenn *ppEnum nicht NULL ist, ruft die MMC-Implementierung von IEnumStringIUnknown::AddRef für die *ppEnum auf. Das Snap-In muss IUnknown::Release aufrufen, wenn die Schnittstelle nicht mehr benötigt wird.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Hinweise

Die zurückgegebene IEnumString-Enumeration stellt eine Momentaufnahme der Auflistung von Zeichenfolgen in der zugrunde liegenden Zeichenfolgentabelle dar, zu der die Enumeration abgerufen wurde. Weder IEnumString::Reset noch IEnumString::Clone übernimmt eine neue Momentaufnahme der Auflistung.

Die Implementierung von IEnumString verwendet den standardmäßigen OLE-Taskspeicherzuteilung, um Arbeitsspeicher für die zurückgegebenen Zeichenfolgen zuzuweisen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile mmc.h
DLL Mmcndmgr.dll

Weitere Informationen

IStringTable

IStringTable::FindString