IVdsService::QueryDriveLetters-Methode (vds.h)

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Gibt Eigenschaftendetails für einen Satz von Laufwerkbuchstaben zurück.

Syntax

HRESULT QueryDriveLetters(
  [in]  WCHAR                 wcFirstLetter,
  [in]  DWORD                 count,
  [out] VDS_DRIVE_LETTER_PROP *pDriveLetterPropArray
);

Parameter

[in] wcFirstLetter

Der erste abzurufende Laufwerkbuchstaben.

[in] count

Die Gesamtanzahl der abzurufenden Laufwerkbuchstaben.

[out] pDriveLetterPropArray

Die Adresse eines Arrays von VDS_DRIVE_LETTER_PROP Strukturen. Die Größe des Arrays ist count. Aufrufer müssen den Arbeitsspeicher für dieses Array zuordnen.

Rückgabewert

Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des HRESULT_FROM_WIN32-Makros zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.

Rückgabecode/-wert BESCHREIBUNG
S_OK
Die Methode wurde erfolgreich abgeschlossen.
VDS_E_INITIALIZED_FAILED
0x80042401L
VDS konnte nicht initialisiert werden. Wenn eine Anwendung diese Methode aufruft, bevor der Dienst die Initialisierung abgeschlossen hat, wird die Methode blockiert, bis die Initialisierung abgeschlossen ist. Wenn bei der Initialisierung ein Fehler auftritt, wird dieser Fehler zurückgegeben.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vds.h
Bibliothek Uuid.lib

Weitere Informationen

IVdsService

VDS_DRIVE_LETTER_PROP