IByteBuffer :: UnlockRegion, méthode

[La méthode UnlockRegion peut être utilisée dans les systèmes d’exploitation spécifiés dans la section relative à la configuration requise. elle 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 offre 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 [ dans]

Offset d’octet pour le début de la plage.

CB [ dans]

Longueur, en octets, de la plage à limiter.

dwLockType [ dans]

Restrictions d’accès précédemment placées dans la plage.

Valeur de retour

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 être déverrouillées par la suite 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 la libération du flux. Deux régions adjacentes ne peuvent pas être verrouillées séparément, puis déverrouillées à l’aide d’un seul appel de déverrouillage.

Exemples

L’exemple suivant illustre 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 [Applications de bureau XP uniquement]
Serveur minimal pris en charge
Windows Serveur 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 en tant que E126F8FE-A7AF-11D0-B88A-00C04FD424B9