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 |
|
| Bibliothèque de types |
|
| DLL |
|
| IID |
IID _ IByteBuffer est défini en tant que E126F8FE-A7AF-11D0-B88A-00C04FD424B9 |