Méthode IDirectWriterLock ::WaitForWriteAccess (objidl.h)
La méthode WaitForWriteAccess obtient un accès en écriture exclusif à un objet de stockage.
Syntaxe
HRESULT WaitForWriteAccess(
[in] DWORD dwTimeout
);
Paramètres
[in] dwTimeout
Spécifie la durée en millisecondes que cette méthode bloque en attendant d’obtenir un accès exclusif en écriture à l’objet de stockage. Si dwTimeout est égal à zéro, la méthode ne bloque pas l’attente d’un accès exclusif pour l’écriture. Le délai d’attente INFINI défini dans le Kit de développement logiciel (SDK) de plateforme est autorisé pour dwTimeout.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
| S_OK | L’appelant a obtenu un accès en écriture exclusif au stockage. |
| S_FALSE | Cette méthode a été appelée à nouveau sans appel intermédiaire à IDirectWriterLock ::ReleaseWriteAccess. |
| STG_E_INUSE | Le délai d’attente spécifié a expiré sans obtenir d’accès exclusif en écriture. |
Remarques
Lorsqu’un stockage est ouvert en mode direct (STGM_DIRECT) avec le STGM_READWRITE|STGM_SHARE_DENY_WRITE, vous pouvez appeler cette méthode pour obtenir un accès exclusif en écriture au stockage.
Cette méthode retourne immédiatement si aucun lecteur n’a le stockage ouvert. Si le stockage est toujours ouvert pour la lecture, cette méthode se bloque pour le dwTimeout spécifié ou jusqu’à ce que les lecteurs actuels ferment le stockage.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | objidl.h |
| Bibliothèque | Uuid.lib |
| DLL | Ole32.dll |