Enumerazione BINDSPEED (oleidl.h)

Indica approssimativamente il tempo di attesa del chiamante per l'associazione a un oggetto.

Sintassi

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

Costanti

BINDSPEED_INDEFINITE Valore: 1 Nessun limite di tempo per l'operazione di associazione.
BINDSPEED_MODERATE Valore: 2 L'operazione di associazione deve essere completata in un intervallo di tempo moderato. Se viene specificato questo flag, l'implementazione di IOleItemContainer::GetObject deve restituire MK_E_EXCEEEDEDDEADLINE a meno che non sia true il tono seguente: L'oggetto è già nello stato in esecuzione. L'oggetto è uno pseudo-oggetto (un oggetto interno al contenitore di elementi, ad esempio un intervallo di celle in un foglio di calcolo o un intervallo di caratteri in un elaboratore di parole). L'oggetto è supportato da un server in-process (quindi è sempre nello stato in esecuzione quando viene caricato). In questo caso, GetObject deve caricare l'oggetto designato e, se la funzione OleIsRunning indica che l'oggetto è in esecuzione, restituire correttamente.
BINDSPEED_IMMEDIATE Valore: 3 Il chiamante attenderà pochi istanti. In questo caso, l'operazione di associazione deve restituire MK_E_EXCEEEDEDDEADLINE a meno che l'oggetto non sia già nello stato in esecuzione o sia uno pseudo-oggetto.

Commenti

L'implementazione del moniker dell'elemento fornito dal sistema è il chiamante primario di IOleItemContainer::GetObject. Il valore BINDSPEED specificato dipende dalla scadenza specificata dal chiamante dell'operazione moniker.

La scadenza viene archiviata nel campo dwTickCountDeadline della struttura BIND_OPTS nel contesto di associazione passato all'operazione moniker. Questo valore è basato sul valore restituito della funzione GetTickCount . Se dwTickCountDeadline è zero, indicando nessuna scadenza, l'implementazione del moniker dell'elemento specifica BINDSPEED_INDEFINITE. Si tratta del valore dwTickCountDeadline predefinito per un contesto di associazione restituito dalla funzione CreateBindCtx . Se la differenza tra dwTickCountDeadline e il valore restituito da GetTickCount è maggiore di 2500, l'implementazione del moniker dell'elemento specifica BINDSPEED_MODERATE. Se la differenza è minore di 2500, l'implementazione del moniker dell'elemento specifica BINDSPEED_IMMEDIATE.

Le implementazioni di GetObject possono usare il valore BINDSPEED come approssimazione rapida della scadenza dell'associazione oppure possono usare il parametro dell'istanza IBindCtx per determinare la scadenza esatta.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	oleidl.h

Vedi anche

BIND_OPTS

Ibindctx

IOleItemContainer::GetObject