Partager via


BINDSPEED, énumération

Indique approximativement combien de temps l'appelant attendra pour le lier à un objet.

Espace de noms :  Microsoft.VisualStudio.OLE.Interop
Assembly :  Microsoft.VisualStudio.OLE.Interop (dans Microsoft.VisualStudio.OLE.Interop.dll)

Syntaxe

'Déclaration
Public Enumeration BINDSPEED
public enum BINDSPEED

Membres

Nom de membre Description
BINDSPEED_INDEFINITE L'opération d'IOleItemContainer : : GetObject doit être complétée dans une quantité modérée d'heure.Si cette balise est spécifiée, l'implémentation d'IOleItemContainer : : GetObject doit retourner MK_E_EXCEEEDEDDEADLINE à moins que l'objet soit l'un des éléments suivants :
  • Déjà dans l'état d'exécution.

  • Un pseudo- objet pseudo-objet (c. autrement dit., un objet interne dans le conteneur d'élément, tel qu'une plage de cellules dans une feuille de calcul ou une plage de caractères dans un traitement de texte).

  • Un objet pris en charge par un serveur in-process (il est toujours dans l'état d'exécution lorsqu'il est chargé).Dans ce cas, IOleItemContainer : : GetObject doit charger l'objet spécifié, et, si la fonction d'OleIsRunning indique que l'objet exécute, le retour avec succès.

BINDSPEED_MODERATE L'appelant attend qu'une courte durée.Dans ce cas, IOleItemContainer : : GetObject doit retourner MK_E_EXCEEEDEDDEADLINE à moins que l'objet soit déjà dans l'état d'exécution ou soit un pseudo- objet pseudo-objet.
BINDSPEED_IMMEDIATE Il n'existe aucune limite de temps sur l'opération de liaison.

Remarques

Les appelants de la méthode d'IOleItemContainer : : GetObject spécifient des valeurs de cette énumération, et les implémenteurs de cette méthode utilisent ces valeurs comme indication pour la rapidité avec laquelle ils doivent compléter leur opération.

L'implémentation fournie par le système de moniker d'élément est l'appelant primaire d'IOleItemContainer : : GetObject.La valeur d'BINDSPEED qu'elle spécifie dépend de la date-butoir spécifiée par l'appelant de l'opération de moniker.

La date-butoir est enregistrée dans le domaine de dwTickCountDeadline de la structure d'BIND_OPTS dans le contexte de liaison passé à l'opération de moniker.Cette valeur est selon la valeur de retour de la fonction de GetTickCount.Si le dwTickCountDeadline est zéro, n'indiquant aucune date-butoir, l'implémentation de moniker d'élément spécifie BINDSPEED_INDEFINITE.(C'est la valeur par défaut de dwTickCountDeadline pour un contexte de liaison retourné par la fonction de CreateBindCtx.) Si la différence entre le dwTickCountDeadline et la valeur retournée par la fonction de GetTickCount est plus supérieure à 2500, l'implémentation de moniker d'élément spécifie BINDSPEED_MODERATE.Si la différence est inférieure à 2500, l'implémentation de moniker d'élément spécifie BINDSPEED_IMMEDIATE.

Les implémentations d'IOleItemContainer : : GetObject peuvent utiliser la valeur d'BINDSPEED comme approximation de raccourci de la date-butoir de liaison, ou elles peuvent utiliser le paramètre d'instance d'IBindCtx pour déterminer la date-butoir exacte.

Voir aussi

Référence

Microsoft.VisualStudio.OLE.Interop, espace de noms