IDiscRecorder ::OpenExclusive, méthode (imapi.h)
Ouvre un enregistreur de disques pour un accès exclusif.
Syntaxe
HRESULT OpenExclusive();
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 :
Remarques
Cette méthode bloque l’accès du système de fichiers à un enregistreur via des applications telles que Explorer. L’enregistreur doit être ouvert avec cette méthode avant de pouvoir utiliser les méthodes suivantes : QueryMediaType, Eject, Erase et Close.
Il est important de fermer l’enregistreur avant d’appeler IDiscMaster ::RecordDisc, sinon il échouera avec IMAPI_E_DEVICE_NOTACCESSIBLE. L’appareil est exclusivement dédié à l’accès via IDiscRecorder ou IDiscMaster, mais pas les deux en même temps. Cela permet de s’assurer qu’il n’y a pas de confusion concernant les opérations autorisées et la propriété d’un enregistreur pendant le contrôle de l’application ou une brûlure.
Un verrou exclusif doit être maintenu aussi court que possible. Les demandes provenant d’autres composants du système d’exploitation ne sont pas mises en file d’attente pour une exécution ultérieure. Au lieu de cela, ils sont simplement échoués. Cela peut entraîner une confusion avec les utilisateurs qui ne pensent pas qu’une brûlure est en cours.
Chaque fois que OpenExclusive est appelé, il apparaît au système de fichiers que le disque a été supprimé. Lorsque l’appel Close correspondant est effectué, il apparaît au système de fichiers que le média a réapparu. Cela peut entraîner des problèmes d’exécution automatique.
Configuration requise
| 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] |
| Plateforme cible | Windows |
| En-tête | imapi.h |
| Bibliothèque | Uuid.lib |
| DLL | Actxprxy.dll |