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 |