CreateAsyncBindCtx, fonction (urlmon.h)
Crée un contexte de liaison asynchrone à utiliser avec des monikers asynchrones.
Syntaxe
HRESULT CreateAsyncBindCtx(
[in] DWORD reserved,
[in] IBindStatusCallback *pBSCb,
[in] IEnumFORMATETC *pEFetc,
[out] IBindCtx **ppBC
);
Paramètres
[in] reserved
Ce paramètre est réservé et doit être 0.
[in] pBSCb
Pointeur vers l’interface IBindStatusCallback utilisée pour recevoir les notifications de disponibilité et de progression des données.
[in] pEFetc
Pointeur vers l’interface IEnumFORMATETC qui peut être utilisée pour énumérer les formats de négociation de format pendant la liaison. Ce paramètre peut être NULL, auquel cas l’appelant n’est pas intéressé par la négociation de format pendant la liaison, et le format par défaut de l’objet est lié.
[out] ppBC
Adresse d’une variable pointeur IBindCtx* qui reçoit le pointeur d’interface vers le nouveau contexte de liaison.
Valeur retournée
Cette fonction peut retourner les valeurs suivantes.
| Code de retour | Description |
|---|---|
|
L’opération s’est terminée avec succès. |
|
La méthode a manqué de mémoire et n’a pas été terminée. |
|
Un ou plusieurs paramètres ne sont pas valides. |
Remarques
Cette fonction inscrit automatiquement les interfaces IBindStatusCallback et IEnumFORMATETC avec le contexte de liaison. Le client peut spécifier des indicateurs à partir de BSCO_OPTION pour indiquer les notifications de rappel qu’il peut recevoir. Si le client ne souhaite pas recevoir de notification, il peut choisir d’implémenter ces méthodes de rappel en tant que stubs de fonction vides (renvoyant E_NOTIMPL), et elles ne doivent pas être appelées.
La fonction RegisterBindStatusCallback peut également être utilisée pour inscrire des interfaces de rappel dans le contexte de liaison.
Configuration requise
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | urlmon.h |
| Bibliothèque | Urlmon.lib |
| DLL | Urlmon.dll |