Metodo ISynchronize::Wait (objidl.h)

  • Articolo

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