IDataObject::EnumDAdvise-Methode (objidl.h)

Erstellt ein Objekt, mit dem die aktuellen Advise-Verbindungen aufgelistet werden können.

Syntax

HRESULT EnumDAdvise(
  [out] IEnumSTATDATA **ppenumAdvise
);

Parameter

[out] ppenumAdvise

Ein Zeiger auf eine IEnumSTATDATA-Zeigervariable , die den Schnittstellenzeiger auf das neue Enumeratorobjekt empfängt. Wenn die Implementierung *ppenumAdvise auf NULL festlegt, gibt es derzeit keine Verbindungen, die Senken empfehlen können.

Rückgabewert

Diese Methode gibt S_OK zurück, wenn das Enumeratorobjekt erfolgreich instanziiert wurde oder keine Verbindungen vorhanden sind. Weitere mögliche Werte sind:

Rückgabecode Beschreibung
E_OUTOFMEMORY
Für den Vorgang ist nicht genügend Arbeitsspeicher verfügbar.
OLE_E_ADVISENOTSUPPORTED
Empfehlungsbenachrichtigungen werden von diesem Objekt nicht unterstützt.

Hinweise

Das von dieser Methode erstellte Enumeratorobjekt implementiert die IEnumSTATDATA-Schnittstelle . IEnumSTATDATA ermöglicht die Enumeration der Daten, die in einem Array von STATDATA-Strukturen gespeichert sind. Jede dieser Strukturen stellt Informationen zu einer einzelnen Beratungsverbindung bereit und enthält FORMATETC - und ADVF-Informationen sowie den Zeiger auf die Empfehlungssenke und das Token, das die Verbindung darstellt.

Hinweise für Anrufer

Es wird empfohlen, das OLE-Datenhalterobjekt zu verwenden, um Beratungsverbindungen zu verarbeiten. Wenn der Zeiger über einen Aufruf von CreateDataAdviseHolder abgerufen wird, wird die Implementierung von IDataObject::EnumDAdvise zu einer einfachen Angelegenheit, um den Aufruf an IDataAdviseHolder::EnumAdvise zu delegieren. Dadurch wird der Enumerator erstellt und der Zeiger auf die OLE-Implementierung von IEnumSTATDATA angegeben. An diesem Punkt können Sie die zugehörigen Methoden aufrufen, um die aktuellen Beratungsverbindungen aufzulisten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile objidl.h

Weitere Informationen

IDataAdviseHolder::EnumAdvise

Idataobject

IEnumSTATDATA