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

El método WaitForWriteAccess obtiene acceso exclusivo de escritura a un objeto de almacenamiento.

Sintaxis

HRESULT WaitForWriteAccess(
  [in] DWORD dwTimeout
);

Parámetros

[in] dwTimeout

Especifica el tiempo en milisegundos que este método bloquea mientras espera a obtener acceso de escritura exclusivo al objeto de almacenamiento. Si dwTimeout es cero, el método no bloquea la espera de acceso exclusivo para escribir. El tiempo de espera INFINITO definido en el SDK de plataforma se permite para dwTimeout.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK El autor de la llamada ha obtenido correctamente acceso exclusivo de escritura al almacenamiento.
S_FALSE Este método se llamó de nuevo sin una llamada intermedia a IDirectWriterLock::ReleaseWriteAccess.
STG_E_INUSE El tiempo de espera especificado expiró sin obtener acceso de escritura exclusivo.

Comentarios

Cuando se abre un almacenamiento en modo directo (STGM_DIRECT) con el STGM_READWRITE|STGM_SHARE_DENY_WRITE, puede llamar a este método para obtener acceso exclusivo de escritura al almacenamiento.

Este método devuelve inmediatamente si ningún lector tiene abierto el almacenamiento. Si el almacenamiento sigue abierto para la lectura, este método se bloquea para el dwTimeout especificado o hasta que los lectores actuales cierren el almacenamiento.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado objidl.h
Library Uuid.lib
Archivo DLL Ole32.dll

Consulte también

IDirectWriterLock::HaveWriteAccess

IDirectWriterLock::ReleaseWriteAccess