Méthode IStream::UnlockRegion (objidl.h)
La méthode UnlockRegion supprime la restriction d’accès sur une plage d’octets précédemment restreinte avec IStream::LockRegion.
Syntaxe
HRESULT UnlockRegion(
[in] ULARGE_INTEGER libOffset,
[in] ULARGE_INTEGER cb,
[in] DWORD dwLockType
);
Paramètres
[in] libOffset
Spécifie le décalage d’octets pour le début de la plage.
[in] cb
Spécifie, en octets, la longueur de la plage à restreindre.
[in] dwLockType
Spécifie les restrictions d’accès précédemment placées sur la plage.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
| S_OK | La plage d’octets a été déverrouillée. |
| E_PENDING | Stockage asynchrone uniquement : une partie ou la totalité des données du flux n’est actuellement pas disponible. |
| STG_E_INVALIDFUNCTION | Le verrouillage n’est pas du tout pris en charge ou le type spécifique de verrou demandé n’est pas pris en charge. |
| STG_E_LOCKVIOLATION | L’opération de déverrouillage demandée ne peut pas être accordée. |
| STG_E_REVERTED | L’objet a été invalidé par une opération de rétablissement au-dessus de lui dans l’arborescence des transactions. |
Notes
IStream::UnlockRegion déverrouille une région précédemment verrouillée avec la méthode IStream::LockRegion . Les régions verrouillées doivent par la suite être déverrouillées explicitement en appelant IStream::UnlockRegion avec exactement les mêmes valeurs pour les paramètres libOffset, cb et dwLockType . La région doit être déverrouillée avant que le flux ne soit libéré. Deux régions adjacentes ne peuvent pas être verrouillées séparément, puis déverrouillées avec un seul appel de déverrouillage.
Spécifications
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | objidl.h |
| Bibliothèque | Uuid.lib |
| DLL | Ole32.dll |