Método IByteBuffer::UnlockRegion

[O método UnlockRegion está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele não está disponível para uso no Windows Server 2003 com Service Pack 1 (SP1) e posterior, Windows Vista, Windows Server 2008 e versões subsequentes do sistema operacional. A interface IStream fornece funcionalidade semelhante.]

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

Sintaxe

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

Parâmetros

libOffset [in]

Deslocamento de bytes para o início do intervalo.

cb [in]

Comprimento, em bytes, do intervalo a ser restrito.

dwLockType [in]

Restrições de acesso colocadas anteriormente no intervalo.

Valor retornado

O valor retornado é um HRESULT. Um valor de S_OK indica que a chamada foi bem-sucedida.

Comentários

O método IByteBuffer::UnlockRegion desbloqueia uma região bloqueada anteriormente usando o método IByteBuffer::LockRegion . As regiões bloqueadas devem ser desbloqueadas explicitamente chamando IByteBuffer::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.

Exemplos

O exemplo a seguir mostra como desbloquear um intervalo de bytes.

HRESULT  hr;

// Unlock a region.
hr = pIByteBuff->UnlockRegion(0, 10, LOCK_EXCLUSIVE);
if (FAILED(hr))
  printf("Failed IByteBuffer::UnlockRegion\n");

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Fim do suporte ao cliente	Windows XP
Fim do suporte ao servidor	Windows Server 2003
Cabeçalho	Scardssp.h
Biblioteca de tipos	Scardssp.tlb
DLL	Scardssp.dll
IID	IID_IByteBuffer é definido como E126F8FE-A7AF-11D0-B88A-00C04FD424B9