Metodo ISynchronize::Wait (objidl.h)

Articolo
08/25/2023

Attende che l'oggetto di sincronizzazione venga segnalato o che venga trascorso un periodo di timeout specificato, a qualsiasi punto venga restituito per primo.

Sintassi

HRESULT Wait(
  [in] DWORD dwFlags,
  [in] DWORD dwMilliseconds
);

Parametri

[in] dwFlags

Opzioni di attesa. I valori possibili vengono ricavati dall'enumerazione COWAIT_FLAGS .

[in] dwMilliseconds

Il tempo di attesa della chiamata prima della restituzione, espresso in millisecondi. Se questo parametro è INFINITE, il chiamante attenderà finché l'oggetto di sincronizzazione non viene segnalato, indipendentemente dal tempo necessario. Se questo parametro è 0, il metodo restituisce immediatamente.

Valore restituito

Questo metodo può restituire i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY e E_FAIL, nonché i valori seguenti.

Codice restituito	Descrizione
S_OK	L'oggetto di sincronizzazione è stato segnalato.
RPC_S_CALLPENDING	Periodo di timeout trascorso prima che l'oggetto di sincronizzazione sia stato segnalato.
RPC_E_NO_SYNC	Non esiste alcun oggetto di sincronizzazione da attendere.

Commenti

Se il chiamante è in attesa in un apartment a thread singolo, Wait immette il ciclo modale COM. Se il chiamante è in attesa in un apartment multithread, il chiamante viene bloccato fino al ritorno di Wait .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	objidl.h (include ObjIdl.h)

Vedi anche

CoWaitForMultipleHandles

Isynchronize

Condividi tramite