Méthode IDirectWriterLock ::WaitForWriteAccess (objidl.h)

  • Article

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

Voir aussi

IDirectWriterLock ::HaveWriteAccess

IDirectWriterLock ::ReleaseWriteAccess