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 |
---|---|
|
Für den Vorgang ist nicht genügend Arbeitsspeicher verfügbar. |
|
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 |