IByteBuffer::UnlockRegion, méthode

Article
06/13/2023

[La méthode UnlockRegion peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il n’est pas disponible pour une utilisation dans Windows Server 2003 avec Service Pack 1 (SP1) et versions ultérieures, Windows Vista, Windows Server 2008 et les versions ultérieures du système d’exploitation. L’interface IStream fournit des fonctionnalités similaires.]

La méthode UnlockRegion supprime la restriction d’accès sur une plage d’octets précédemment restreinte à l’aide de IByteBuffer::LockRegion.

Syntaxe

HRESULT UnlockRegion(
  [in] LONG libOffset,
  [in] LONG cb,
  [in] LONG dwLockType
);

Paramètres

libOffset [in]: Décalage d’octets pour le début de la plage.
cb [in]: Longueur, en octets, de la plage à restreindre.
dwLockType [in]: Restrictions d’accès précédemment placées sur la plage.

Valeur retournée

La valeur de retour est un HRESULT. La valeur S_OK indique que l’appel a réussi.

Notes

La méthode IByteBuffer::UnlockRegion déverrouille une région précédemment verrouillée à l’aide de la méthode IByteBuffer::LockRegion . Les régions verrouillées doivent par la suite être déverrouillées explicitement en appelant IByteBuffer::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.

Exemples

L’exemple suivant montre le déverrouillage d’une plage d’octets.

HRESULT  hr;

// Unlock a region.
hr = pIByteBuff->UnlockRegion(0, 10, LOCK_EXCLUSIVE);
if (FAILED(hr))
  printf("Failed IByteBuffer::UnlockRegion\n");

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Fin de la prise en charge des clients	Windows XP
Fin de la prise en charge des serveurs	Windows Server 2003
En-tête	Scardssp.h
Bibliothèque de types	Scardssp.tlb
DLL	Scardssp.dll
IID	IID_IByteBuffer est défini comme E126F8FE-A7AF-11D0-B88A-00C04FD424B9

Partager via