CreateAsyncBindCtx-Funktion (urlmon.h)

  • Artikel

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
S_OK
 Der Vorgang wurde erfolgreich abgeschlossen.
E_OUTOFMEMORY
Für die Methode war der Arbeitsspeicher nicht mehr verfügbar und wurde nicht abgeschlossen.
E_INVALIDARG
 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

Weitere Informationen

IBindStatusCallback

RegisterBindStatusCallback