IByteBuffer::UnlockRegion-Methode

Artikel
06/13/2023

[Die UnlockRegion-Methode ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es ist nicht für die Verwendung in Windows Server 2003 mit Service Pack 1 (SP1) und höher, Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems verfügbar. Die IStream-Schnittstelle bietet ähnliche Funktionen.]

Die UnlockRegion-Methode entfernt die Zugriffsbeschränkung für einen Bytesbereich, der zuvor mithilfe von IByteBuffer::LockRegion eingeschränkt wurde.

Syntax

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

Parameter

libOffset [in]: Byteoffset für den Anfang des Bereichs.
cb [in]: Länge des zu beschränkenden Bereichs in Bytes.
dwLockType [in]: Zugriffsbeschränkungen, die zuvor für den Bereich festgelegt wurden.

Rückgabewert

Der Rückgabewert ist ein HRESULT. Der Wert S_OK gibt an, dass der Aufruf erfolgreich war.

Bemerkungen

Die IByteBuffer::UnlockRegion-Methode entsperrt eine zuvor gesperrte Region mithilfe der IByteBuffer::LockRegion-Methode . Gesperrte Regionen müssen später explizit entsperrt werden, indem IByteBuffer::UnlockRegion mit genau den gleichen Werten für die Parameter libOffset, cb und dwLockType aufgerufen wird. Die Region muss entsperrt werden, bevor der Stream freigegeben wird. Zwei angrenzende Regionen können nicht separat gesperrt und dann mit einem einzelnen Entsperrungsaufruf entsperrt werden.

Beispiele

Das folgende Beispiel zeigt das Entsperren eines Bytesbereichs.

HRESULT  hr;

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Ende des Supports (Client)	Windows XP
Ende des Supports (Server)	Windows Server 2003
Header	Scardssp.h
Typbibliothek	Scardssp.tlb
DLL	Scardssp.dll
IID	IID_IByteBuffer ist definiert als E126F8FE-A7AF-11D0-B88A-00C04FD424B9