Condividi tramite


Funzione CreateAsyncBindCtx (urlmon.h)

Crea un contesto di associazione asincrona da usare con moniker asincroni.

Sintassi

HRESULT CreateAsyncBindCtx(
  [in]  DWORD               reserved,
  [in]  IBindStatusCallback *pBSCb,
  [in]  IEnumFORMATETC      *pEFetc,
  [out] IBindCtx            **ppBC
);

Parametri

[in] reserved

Questo parametro è riservato e deve essere 0.

[in] pBSCb

Puntatore all'interfaccia IBindStatusCallback usata per ricevere la disponibilità e la notifica dello stato dei dati.

[in] pEFetc

Puntatore all'interfaccia IEnumFORMATETC che può essere usata per enumerare i formati per la negoziazione del formato durante l'associazione. Questo parametro può essere NULL, nel qual caso il chiamante non è interessato alla negoziazione del formato durante l'associazione e il formato predefinito dell'oggetto verrà associato.

[out] ppBC

Indirizzo di una variabile puntatore IBindCtx* che riceve il puntatore dell'interfaccia al nuovo contesto di associazione.

Valore restituito

Questa funzione può restituire i valori seguenti.

Codice restituito Descrizione
S_OK
Operazione riuscita.
E_OUTOFMEMORY
Il metodo ha esaurito la memoria e non è stato completato.
E_INVALIDARG
Uno o più parametri non sono validi.

Commenti

Questa funzione registra automaticamente le interfacce IBindStatusCallback e IEnumFORMATETC con il contesto di associazione. Il client può specificare i flag da BSCO_OPTION per indicare quali notifiche di callback il client è in grado di ricevere. Se il client non desidera ricevere determinate notifiche, può scegliere di implementare tali metodi di callback come stub di funzioni vuoti (restituzione di E_NOTIMPL) e non deve essere chiamato.

La funzione RegisterBindStatusCallback può essere usata anche per registrare le interfacce di callback nel contesto di associazione.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione urlmon.h
Libreria Urlmon.lib
DLL Urlmon.dll

Vedi anche

IBindStatusCallback

RegisterBindStatusCallback