Méthode IDiscMaster2::get__NewEnum (imapi2.h)
Récupère une liste des périphériques CD et DVD installés sur l’ordinateur.
Syntaxe
HRESULT get__NewEnum(
[out] IEnumVARIANT **ppunk
);
Paramètres
[out] ppunk
Interface IEnumVariant que vous utilisez pour énumérer les périphériques CD et DVD installés sur l’ordinateur. Les éléments de l’énumération sont des variantes dont le type est VT_BSTR. Utilisez le membre bstrVal pour récupérer l’identificateur unique de l’appareil.
Valeur retournée
S_OK est retourné lorsque le nombre d’éléments demandés (celte) est retourné avec succès ou que le nombre d’éléments retournés (pceltFetched) est inférieur au nombre d’éléments demandés. Les paramètres celte et pceltFetched sont définis par IEnumVariant.
D’autres codes de réussite peuvent être retournés suite à 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 |
|---|---|
|
Le pointeur n’est pas valide.
Valeur : 0x80004003 |
Notes
L’énumération est une instantané des appareils sur l’ordinateur au moment de l’appel et ne reflète pas les appareils qui sont ajoutés et supprimés. Pour recevoir une notification lorsqu’un appareil est ajouté ou supprimé de l’ordinateur, implémentez l’interface DDiscMaster2Events .
Pour récupérer un identificateur unique, consultez la propriété IDiscMaster2::get_Item .
L’identificateur de l’appareil est garanti comme étant unique et statique pour un appareil donné, tel qu’il est reconnu par Windows Plug-and-Play. Vous pouvez utiliser l’identificateur comme valeur de clé pour enregistrer le graveur par défaut de l’utilisateur, et peut également être utilisé pour mettre en cache d’autres informations statiques spécifiques à l’appareil (par exemple, VendorID et ProductID) par une application avancée.
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 |