CreateAsyncBindCtx-Funktion (urlmon.h)
Erstellt einen asynchronen Bindungskontext für die Verwendung mit asynchronen Monikern.
Syntax
HRESULT CreateAsyncBindCtx(
[in] DWORD reserved,
[in] IBindStatusCallback *pBSCb,
[in] IEnumFORMATETC *pEFetc,
[out] IBindCtx **ppBC
);
Parameter
[in] reserved
Dieser Parameter ist reserviert und muss 0 sein.
[in] pBSCb
Ein Zeiger auf die IBindStatusCallback-Schnittstelle , die zum Empfangen von Datenverfügbarkeits- und Statusbenachrichtigungen verwendet wird.
[in] pEFetc
Ein Zeiger auf die IEnumFORMATETC-Schnittstelle , die zum Auflisten von Formataushandlungsformaten während der Bindung verwendet werden kann. Dieser Parameter kann NULL sein. In diesem Fall ist der Aufrufer nicht an der Formataushandlung während der Bindung interessiert, und an das Standardformat des Objekts wird gebunden.
[out] ppBC
Adresse einer IBindCtx*-Zeigervariable, die den Schnittstellenzeiger auf den neuen Bindungskontext empfängt.
Rückgabewert
Diese Funktion kann die folgenden Werte zurückgeben.
Rückgabecode | BESCHREIBUNG |
---|---|
|
Der Vorgang wurde erfolgreich abgeschlossen. |
|
Für die Methode war der Arbeitsspeicher nicht mehr verfügbar und wurde nicht abgeschlossen. |
|
Mindestens ein Parameter ist ungültig. |
Hinweise
Diese Funktion registriert die Schnittstellen IBindStatusCallback und IEnumFORMATETC automatisch beim Bindungskontext. Der Client kann Flags von BSCO_OPTION angeben, um anzugeben, welche Rückrufbenachrichtigungen der Client empfangen kann. Wenn der Client keine bestimmte Benachrichtigung erhalten möchte, kann er diese Rückrufmethoden als leere Funktionsstubs implementieren (E_NOTIMPL zurückgeben), und sie sollten nicht aufgerufen werden.
Die Funktion RegisterBindStatusCallback kann auch verwendet werden, um Rückrufschnittstellen im Bindungskontext zu registrieren.
Anforderungen
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | urlmon.h |
Bibliothek | Urlmon.lib |
DLL | Urlmon.dll |