Compartilhar via


Método IStream::UnlockRegion (objidl.h)

O método UnlockRegion remove a restrição de acesso em um intervalo de bytes anteriormente restritos com IStream::LockRegion.

Sintaxe

HRESULT UnlockRegion(
  [in] ULARGE_INTEGER libOffset,
  [in] ULARGE_INTEGER cb,
  [in] DWORD          dwLockType
);

Parâmetros

[in] libOffset

Especifica o deslocamento de bytes para o início do intervalo.

[in] cb

Especifica, em bytes, o comprimento do intervalo a ser restrito.

[in] dwLockType

Especifica as restrições de acesso colocadas anteriormente no intervalo.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK O intervalo de bytes foi desbloqueado.
E_PENDING Somente armazenamento assíncrono: parte ou todos os dados do fluxo estão indisponíveis no momento.
STG_E_INVALIDFUNCTION Não há suporte para bloqueio ou não há suporte para o tipo específico de bloqueio solicitado.
STG_E_LOCKVIOLATION A operação de desbloqueio solicitada não pode ser concedida.
STG_E_REVERTED O objeto foi invalidado por uma operação de reverter acima dele na árvore de transações.

Comentários

IStream::UnlockRegion desbloqueia uma região bloqueada anteriormente com o método IStream::LockRegion . As regiões bloqueadas devem ser desbloqueadas explicitamente chamando IStream::UnlockRegion com exatamente os mesmos valores para os parâmetros libOffset, cb e dwLockType . A região deve ser desbloqueada antes que o fluxo seja liberado. Duas regiões adjacentes não podem ser bloqueadas separadamente e desbloqueadas com uma única chamada de desbloqueio.

Requisitos

   
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

IStream – Implementação de arquivo composto

IStream::LockRegion

LOCKTYPE