ÉNUMÉRATION BINDSPEED (oleidl.h)

Article
03/01/2024

Indique la durée d'attente approximative de l'appelant pour se lier à un objet.

Syntax

typedef enum tagBINDSPEED {
  BINDSPEED_INDEFINITE = 1,
  BINDSPEED_MODERATE = 2,
  BINDSPEED_IMMEDIATE = 3
} BINDSPEED;

Constantes


`BINDSPEED_INDEFINITE` Valeur : 1 Il n'existe aucune limite de temps sur l'exécution de liaison.
`BINDSPEED_MODERATE` Valeur : 2 L’opération de liaison doit être effectuée dans un délai modéré. Si cet indicateur est spécifié, l’implémentation de IOleItemContainer ::GetObject doit retourner MK_E_EXCEEEDEDDEADLINE, sauf si le ton de ce qui suit est vrai : L’objet est déjà en cours d’exécution. L’objet est un pseudo-objet (un objet interne au conteneur d’éléments, tel qu’une plage de cellules dans une feuille de calcul ou une plage de caractères dans un traitement de texte). L’objet est pris en charge par un serveur in-process (il est donc toujours à l’état d’exécution lorsqu’il est chargé). Dans ce cas, GetObject doit charger l’objet désigné et, si la fonction OleIsRunning indique que l’objet est en cours d’exécution, retourner correctement.
`BINDSPEED_IMMEDIATE` Valeur : 3 L'appelant n'attend que pendant une courte durée. Dans ce cas, l’opération de liaison doit retourner MK_E_EXCEEEDEDDEADLINE, sauf si l’objet est déjà en cours d’exécution ou s’il s’agit d’un pseudo-objet.

Remarques

L’implémentation du moniker d’élément fourni par le système est l’appelant principal de IOleItemContainer ::GetObject. La valeur BINDSPEED qu’elle spécifie dépend de l’échéance spécifiée par l’appelant de l’opération moniker.

L’échéance est stockée dans le champ dwTickCountDeadline de la structure BIND_OPTS dans le contexte de liaison passé à l’opération moniker. Cette valeur est basée sur la valeur de retour de la fonction GetTickCount . Si dwTickCountDeadline est égal à zéro, ce qui n’indique aucune échéance, l’implémentation du moniker d’élément spécifie BINDSPEED_INDEFINITE. (Il s’agit de la valeur dwTickCountDeadline par défaut pour un contexte de liaison retourné par la fonction CreateBindCtx .) Si la différence entre dwTickCountDeadline et la valeur retournée par GetTickCount est supérieure à 2500, l’implémentation du moniker d’élément spécifie BINDSPEED_MODERATE. Si la différence est inférieure à 2500, l’implémentation du moniker d’élément spécifie BINDSPEED_IMMEDIATE.

Les implémentations de GetObject peuvent utiliser la valeur BINDSPEED comme approximation de raccourci de l’échéance de liaison, ou utiliser le paramètre IBindCtx instance pour déterminer l’échéance exacte.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	oleidl.h

Voir aussi

BIND_OPTS

IBindCtx

IOleItemContainer ::GetObject

Partager via