Freigeben über


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