Compartilhar via


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

O método UnlockRegion remove a restrição de acesso em um intervalo de bytes bloqueado anteriormente.

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 restrito.

[in] dwLockType

Especifica o tipo de restrições de acesso colocadas anteriormente no intervalo. Esse parâmetro usa um valor da enumeração LOCKTYPE .

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK O intervalo de bytes foi desbloqueado.
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 O desbloqueio solicitado não pode ser concedido.

Comentários

ILockBytes::UnlockRegion desbloqueia uma região bloqueada anteriormente com uma chamada para ILockBytes::LockRegion. Cada região bloqueada deve ser desbloqueada explicitamente, usando os mesmos valores para os parâmetros libOffset, cb e dwLockType como nas chamadas correspondentes para ILockBytes::LockRegion. Duas regiões adjacentes não podem ser bloqueadas separadamente e desbloqueadas com uma única chamada de desbloqueio.

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

ILockBytes – implementação de File-Based

ILockBytes – Implementação de memória global

ILockBytes::LockRegion

LOCKTYPE