Método IByteBuffer::UnlockRegion

[El método UnlockRegion está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. No está disponible para su uso en Windows Server 2003 con Service Pack 1 (SP1) y versiones posteriores, Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo. La interfaz IStream proporciona una funcionalidad similar.]

El método UnlockRegion quita la restricción de acceso en un intervalo de bytes previamente restringido mediante IByteBuffer::LockRegion.

Sintaxis

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

Parámetros

libOffset [in]

Desplazamiento de bytes para el principio del intervalo.

cb [in]

Longitud, en bytes, del intervalo que se va a restringir.

dwLockType [in]

Restricciones de acceso colocadas anteriormente en el intervalo.

Valor devuelto

El valor devuelto es un HRESULT. Un valor de S_OK indica que la llamada se realizó correctamente.

Comentarios

El método IByteBuffer::UnlockRegion desbloquea una región bloqueada previamente mediante el método IByteBuffer::LockRegion . Las regiones bloqueadas deben desbloquearse explícitamente llamando a IByteBuffer::UnlockRegion con exactamente los mismos valores para los parámetros libOffset, cb y dwLockType . La región debe desbloquearse antes de que se libere la secuencia. Dos regiones adyacentes no se pueden bloquear por separado y, a continuación, desbloquear con una sola llamada de desbloqueo.

Ejemplos

En el ejemplo siguiente se muestra cómo desbloquear un 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	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Fin de compatibilidad de cliente	Windows XP
Fin de compatibilidad de servidor	Windows Server 2003
Encabezado	Scardssp.h
Biblioteca de tipos	Scardssp.tlb
Archivo DLL	Scardssp.dll
IID	IID_IByteBuffer se define como E126F8FE-A7AF-11D0-B88A-00C04FD424B9