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

Voir aussi

IStream - Implémentation de fichier composé

IStream::LockRegion

LOCKTYPE