IDiscRecorder2::ReleaseExclusiveAccess, méthode (imapi2.h)
Libère l’accès exclusif à l’appareil.
Syntaxe
HRESULT ReleaseExclusiveAccess();
Valeur de retour
S_OK est retourné en cas de réussite, mais d’autres codes de réussite peuvent être retournés à la suite de l’implémentation. Les codes d’erreur suivants sont généralement retournés en cas d’échec de l’opération, mais ne représentent pas les seules valeurs d’erreur possibles :
| Code de retour | Description |
|---|---|
|
Défaillance non spécifiée.
Valeur : 0x80004005 |
|
Échec de l’allocation de la mémoire requise.
Valeur : 0x8007000E |
|
L’appareil n’a pas pu accepter la commande dans le délai imparti. Cela peut être dû au fait que l’appareil est entré dans un état incohérent, ou que la valeur du délai d’expiration de la commande doit être augmentée.
Valeur : 0xC0AA020D |
|
Le handle spécifié n’est pas valide.
Valeur : 6 |
|
La ressource réseau ou le périphérique spécifié n’est plus disponible.
Valeur : 55 |
|
L’appareil associé à cet enregistreur lors de la dernière opération a été verrouillé exclusivement, ce qui a provoqué l’échec de cette opération.
Valeur : 0xC0AA0210 |
Notes
Chaque enregistreur a un nombre de verrous. Le premier appel à un enregistreur verrouille l’appareil pour un accès exclusif. Les applications peuvent utiliser la méthode IDiscRecorder2::AcquireExclusiveAccess plusieurs fois pour appliquer plusieurs verrous sur un appareil. Chaque appel incrémente le nombre de verrous d’un.
Lors du déverrouillage d’un enregistreur, le nombre de verrous doit atteindre zéro pour libérer l’appareil pour d’autres clients. L’appel de la méthode ReleaseExclusiveAccess décrémente le nombre de verrous d’un.
Un nombre égal d’appels aux méthodes AcquireExclusiveAccess et ReleaseExclusiveAccess sont nécessaires pour libérer un appareil. Lorsque le nombre de verrous atteint zéro, l’appareil d’enregistrement est libre ; le dernier verrou a été supprimé.
Configuration requise
| Client minimal pris en charge | Windows Vista, Windows XP avec SP2 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | imapi2.h |