Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Ruft den Gerätedeskriptor für das Gerät ab.
Syntax
HRESULT GetDeviceDescriptor(
[out] BYTE **data,
[out] ULONG_IMAPI2_DEVICE_DESCRIPTOR *byteSize
);
Parameter
[out] data
Datenpuffer, der den Deskriptor des Speichergeräts enthält. Details zum Inhalt des Datenpuffers finden Sie in der STORAGE_DEVICE_DESCRIPTOR-Struktur im DDK.
Wenn Sie fertig sind, rufen Sie die CoTaskMemFree-Funktion auf, um den Arbeitsspeicher freizugeben.
[out] byteSize
Größe des Datenpuffers in Bytes.
Rückgabewert
S_OK wird bei Erfolg zurückgegeben, aber andere Erfolgscodes können als Ergebnis der Implementierung zurückgegeben werden. Die folgenden Fehlercodes werden häufig bei Vorgangsfehlern zurückgegeben, stellen aber nicht die einzigen möglichen Fehlerwerte dar:
| Rückgabecode | Beschreibung |
|---|---|
|
Der Zeiger ist ungültig.
Wert: 0x80004003 |
|
Unspezifizierter Fehler.
Wert: 0x80004005 |
|
Fehler beim Zuweisen des erforderlichen Arbeitsspeichers.
Wert: 0x8007000E |
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 |