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