IDiscMaster2::get__NewEnum-Methode (imapi2.h)
Ruft eine Liste der auf dem Computer installierten CD- und DVD-Geräte ab.
Syntax
HRESULT get__NewEnum(
[out] IEnumVARIANT **ppunk
);
Parameter
[out] ppunk
Eine IEnumVariant-Schnittstelle , mit der Sie die auf dem Computer installierten CD- und DVD-Geräte auflisten. Die Elemente der Enumeration sind Varianten, deren Typ VT_BSTR ist. Verwenden Sie das bstrVal-Element , um den eindeutigen Bezeichner des Geräts abzurufen.
Rückgabewert
S_OK wird zurückgegeben, wenn die Anzahl der angeforderten Elemente (celt) erfolgreich zurückgegeben wird oder die Anzahl der zurückgegebenen Elemente (pceltFetched) kleiner als die Anzahl der angeforderten Elemente ist. Die Parameter celt und pceltFetched werden durch IEnumVariant definiert.
Andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Einem Vorgangsfehler zurückgegeben, stellen jedoch nicht die einzigen möglichen Fehlerwerte dar:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Zeiger ist ungültig.
Wert: 0x80004003 |
Hinweise
Die Enumeration ist eine Momentaufnahme der Geräte auf dem Computer zum Zeitpunkt des Aufrufs und spiegelt keine Geräte wider, die hinzugefügt und entfernt werden. Implementieren Sie die DDiscMaster2Events-Schnittstelle , um Benachrichtigungen zu erhalten, wenn ein Gerät dem Computer hinzugefügt oder daraus entfernt wird.
Informationen zum Abrufen eines einzelnen Bezeichners finden Sie in der Eigenschaft IDiscMaster2::get_Item .
Der Gerätebezeichner ist garantiert eindeutig und statisch für ein bestimmtes Gerät, wie von Windows Plug and Play erkannt. Sie können den Bezeichner als Schlüsselwert verwenden, um den Standardbrenner des Benutzers zu speichern, und sie können auch verwendet werden, um andere gerätespezifische statische Informationen (z. B. VendorID und ProductID) von einer erweiterten Anwendung zwischenzuspeichern.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista, Windows XP mit SP2 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | imapi2.h |