Metodo IDirectWriterLock::WaitForWriteAccess (objidl.h)
Il metodo WaitForWriteAccess ottiene l'accesso in scrittura esclusivo a un oggetto di archiviazione.
Sintassi
HRESULT WaitForWriteAccess(
[in] DWORD dwTimeout
);
Parametri
[in] dwTimeout
Specifica il tempo in millisecondi che questo metodo blocca durante l'attesa di ottenere l'accesso esclusivo in scrittura all'oggetto di archiviazione. Se dwTimeout è zero, il metodo non blocca l'attesa dell'accesso esclusivo per la scrittura. Il timeout INFINITO definito in Platform SDK è consentito per dwTimeout.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Codice restituito | Descrizione |
|---|---|
| S_OK | Il chiamante ha ottenuto correttamente l'accesso in scrittura esclusivo all'archiviazione. |
| S_FALSE | Questo metodo è stato chiamato di nuovo senza una chiamata di intervento a IDirectWriterLock::ReleaseWriteAccess. |
| STG_E_INUSE | Timeout specificato scaduto senza ottenere l'accesso in scrittura esclusivo. |
Commenti
Quando una risorsa di archiviazione viene aperta in modalità diretta (STGM_DIRECT) con il STGM_READWRITE|STGM_SHARE_DENY_WRITE, è possibile chiamare questo metodo per ottenere l'accesso esclusivo in scrittura all'archiviazione.
Questo metodo restituisce immediatamente se nessun lettore ha aperto l'archiviazione. Se l'archiviazione è ancora aperta per la lettura, questo metodo blocca per il dwTimeout specificato o fino a quando i lettori correnti chiudeno l'archiviazione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [app desktop | App UWP] |
| Server minimo supportato | Windows 2000 Server [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | objidl.h |
| Libreria | Uuid.lib |
| DLL | Ole32.dll |