ILockBytes::UnlockRegion-Methode (objidl.h)

Die UnlockRegion-Methode entfernt die Zugriffsbeschränkung für einen zuvor gesperrten Bytebereich.

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 eingeschränkten Bereichs in Bytes an.

[in] dwLockType

Gibt den Typ der Zugriffseinschränkungen an, die zuvor für den Bereich gelten. Dieser Parameter verwendet einen Wert aus der LOCKTYPE-Enumeration .

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	Beschreibung
S_OK	Der Bytebereich wurde entsperrt.
STG_E_INVALIDFUNCTION	Das Sperren wird überhaupt nicht unterstützt, oder der spezifische typ der angeforderten Sperre wird nicht unterstützt.
STG_E_LOCKVIOLATION	Die angeforderte Entsperrung kann nicht gewährt werden.

Hinweise

ILockBytes::UnlockRegion entsperrt eine Region, die zuvor mit einem Aufruf von ILockBytes::LockRegion gesperrt wurde. Jede gesperrte Region muss explizit entsperrt werden, wobei die gleichen Werte für die Parameter libOffset, cb und dwLockType wie in den übereinstimmenden Aufrufen von ILockBytes::LockRegion verwendet werden. Zwei angrenzende Regionen können nicht separat gesperrt und dann mit einem einzigen Entsperrungsaufruf entsperrt werden.

Anforderungen

Anforderung	Wert
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

ILockBytes – File-Based Implementierung

ILockBytes – Globale Speicherimplementierung

ILockBytes::LockRegion

LOCKTYPE