Freigeben über


BINDSPEED-Enumeration (oleidl.h)

Gibt an, wie lange der Aufrufer ungefähr warten wird, um an ein Objekt zu binden.

Syntax

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

Konstanten

 
BINDSPEED_INDEFINITE
Wert: 1
Es gibt kein Zeitlimit für den Bindungsvorgang.
BINDSPEED_MODERATE
Wert: 2
Der Bindungsvorgang muss in mäßiger Zeit abgeschlossen werden.

Wenn dieses Flag angegeben ist, sollte die Implementierung von IOleItemContainer::GetObject MK_E_EXCEEEDEDDEADLINE zurückgeben, es sei denn, der folgende Ton ist richtig:


  • Das Objekt befindet sich bereits im Ausführungszustand.

  • Das Objekt ist ein Pseudoobjekt (ein internes Objekt des Elementcontainers, z. B. ein Zellbereich in einer Kalkulationstabelle oder ein Zeichenbereich in einer Textverarbeitung).

  • Das Objekt wird von einem prozessinternen Server unterstützt (daher befindet es sich beim Laden immer im Ausführungszustand). In diesem Fall sollte GetObject das angegebene Objekt laden und, wenn die OleIsRunning-Funktion angibt, dass das Objekt ausgeführt wird, erfolgreich zurückgeben.

BINDSPEED_IMMEDIATE
Wert: 3
Der Aufrufer wartet nur kurze Zeit. In diesem Fall sollte der Bindungsvorgang MK_E_EXCEEEDEDDEADLINE zurückgeben, es sei denn, das Objekt befindet sich bereits im Ausführungszustand oder ist ein Pseudoobjekt.

Hinweise

Die vom System bereitgestellte Elementmonikerimplementierung ist der primäre Aufrufer von IOleItemContainer::GetObject. Der bindspeed-Wert , den er angibt, hängt von der vom Aufrufer des Monikervorgangs angegebenen Frist ab.

Der Stichtag wird im DwTickCountDeadline-Feld der BIND_OPTS-Struktur im Bindungskontext gespeichert, der an den Moniker-Vorgang übergeben wird. Dieser Wert basiert auf dem Rückgabewert der GetTickCount-Funktion . Wenn dwTickCountDeadline null ist und keine Frist angibt, gibt die Elementmonikerimplementierung BINDSPEED_INDEFINITE an. (Dies ist der dwTickCountDeadline-Standardwert für einen Bindungskontext, der von der CreateBindCtx-Funktion zurückgegeben wird.) Wenn der Unterschied zwischen dwTickCountDeadline und dem von GetTickCount zurückgegebenen Wert größer als 2500 ist, gibt die Elementmonikerimplementierung BINDSPEED_MODERATE an. Wenn die Differenz kleiner als 2500 ist, gibt die Elementmonikerimplementierung BINDSPEED_IMMEDIATE an.

Implementierungen von GetObject können den BINDSPEED-Wert als Tastenkombinationsannäherung des Bindungstermins verwenden, oder sie können den Parameter IBindCtx instance verwenden, um den genauen Termin zu bestimmen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Kopfzeile oleidl.h

Weitere Informationen

BIND_OPTS

Ibindctx

IOleItemContainer::GetObject