BINDSPEED-Enumeration (oleidl.h)

Artikel
03/01/2024

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

Freigeben über