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 |