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

O método WaitForWriteAccess obtém acesso de gravação exclusivo a um objeto de armazenamento.

Sintaxe

HRESULT WaitForWriteAccess(
  [in] DWORD dwTimeout
);

Parâmetros

[in] dwTimeout

Especifica o tempo em milissegundos que esse método bloqueia enquanto aguarda para obter acesso de gravação exclusivo ao objeto de armazenamento. Se dwTimeout for zero, o método não bloqueará a espera por acesso exclusivo para gravação. O tempo limite INFINITE definido no SDK da Plataforma é permitido para dwTimeout.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O chamador obteve com êxito acesso de gravação exclusivo ao armazenamento.
S_FALSE	Esse método foi chamado novamente sem uma chamada intermediária para IDirectWriterLock::ReleaseWriteAccess.
STG_E_INUSE	O tempo limite especificado expirou sem obter acesso de gravação exclusivo.

Comentários

Quando um armazenamento é aberto no modo direto (STGM_DIRECT) com o STGM_READWRITE|STGM_SHARE_DENY_WRITE, você pode chamar esse método para obter acesso de gravação exclusivo ao armazenamento.

Esse método retornará imediatamente se nenhum leitor tiver o armazenamento aberto. Se o armazenamento ainda estiver aberto para leitura, esse método será bloqueado para o dwTimeout especificado ou até que os leitores atuais fechem o armazenamento.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	objidl.h
Biblioteca	Uuid.lib
DLL	Ole32.dll

Confira também

IDirectWriterLock::HaveWriteAccess

IDirectWriterLock::ReleaseWriteAccess