IStream::UnlockRegion-Methode (objidl.h)

Die UnlockRegion-Methode entfernt die Zugriffsbeschränkung für einen Bytebereich, der zuvor mit IStream::LockRegion eingeschränkt wurde.

Syntax

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

Parameter

[in] libOffset

Gibt den Byteoffset für den Anfang des Bereichs an.

[in] cb

Gibt die Länge des einzuschränkenden Bereichs in Bytes an.

[in] dwLockType

Gibt die Zugriffseinschränkungen an, die zuvor für den Bereich gelten.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
S_OK	Der Bytebereich wurde entsperrt.
E_PENDING	Nur asynchroner Speicher: Ein Teil oder alle Daten des Datenstroms sind derzeit nicht verfügbar.
STG_E_INVALIDFUNCTION	Das Sperren wird überhaupt nicht unterstützt, oder der spezifische typ der angeforderten Sperre wird nicht unterstützt.
STG_E_LOCKVIOLATION	Der angeforderte Entsperrungsvorgang kann nicht gewährt werden.
STG_E_REVERTED	Das Objekt wurde durch einen rückgängig machen Vorgang darüber in der Transaktionsstruktur ungültig gemacht.

Hinweise

IStream::UnlockRegion entsperrt eine Region, die zuvor mit der IStream::LockRegion-Methode gesperrt wurde. Gesperrte Regionen müssen später explizit entsperrt werden, indem IStream::UnlockRegion mit genau denselben 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 einzigen Entsperrungsaufruf entsperrt werden.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	objidl.h
Bibliothek	Uuid.lib
DLL	Ole32.dll

Weitere Informationen

IStream – Implementierung von Zusammengesetzten Dateien

IStream::LockRegion

LOCKTYPE