IDirectWriterLock::WaitForWriteAccess-Methode (objidl.h)
Die WaitForWriteAccess-Methode erhält exklusiven Schreibzugriff auf ein Speicherobjekt.
Syntax
HRESULT WaitForWriteAccess(
[in] DWORD dwTimeout
);
Parameter
[in] dwTimeout
Gibt die Zeit in Millisekunden an, die diese Methode blockiert, während sie darauf wartet, exklusiven Schreibzugriff auf das Speicherobjekt zu erhalten. Wenn dwTimeout null ist, blockiert die -Methode das Warten auf den exklusiven Zugriff zum Schreiben nicht. Das im Platform SDK definierte INFINITE-Timeout ist für dwTimeout zulässig.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
| S_OK | Der Aufrufer hat erfolgreich exklusiven Schreibzugriff auf den Speicher erhalten. |
| S_FALSE | Diese Methode wurde ohne einen dazwischen liegenden Aufruf von IDirectWriterLock::ReleaseWriteAccess erneut aufgerufen. |
| STG_E_INUSE | Das angegebene Timeout ist ohne exklusiven Schreibzugriff abgelaufen. |
Hinweise
Wenn ein Speicher im direkten Modus (STGM_DIRECT) mit dem STGM_READWRITE|STGM_SHARE_DENY_WRITE können Sie diese Methode aufrufen, um exklusiven Schreibzugriff auf den Speicher zu erhalten.
Diese Methode gibt sofort zurück, wenn der Speicher nicht geöffnet ist. Wenn der Speicher weiterhin zum Lesen geöffnet ist, blockiert diese Methode für das angegebene dwTimeout oder bis die aktuellen Reader den Speicher schließen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [Desktop-Apps | UWP-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [Desktop-Apps | UWP-Apps] |
| Zielplattform | Windows |
| Kopfzeile | objidl.h |
| Bibliothek | Uuid.lib |
| DLL | Ole32.dll |