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 |