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