SetupQueryDrivesInDiskSpaceListA-Funktion (setupapi.h)
[Diese Funktion steht für die Verwendung in den im Abschnitt "Anforderungen" angegebenen Betriebssystemen zur Verfügung. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein. SetupAPI sollte nicht mehr für die Installation von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Anwendungsinstallationsprogrammen. SetupAPI wird weiterhin für die Installation von Gerätetreibern verwendet.]
Die SetupQueryDrivesInDiskSpaceList-Funktion füllt einen Puffer mit einer Liste der Laufwerke aus, auf die durch die dateivorgänge verwiesen wird, die in der Liste des Speicherplatzes aufgeführt sind.
Syntax
WINSETUPAPI BOOL SetupQueryDrivesInDiskSpaceListA(
[in] HDSKSPC DiskSpace,
[in, out] PSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[in, out] PDWORD RequiredSize
);
Parameter
[in] DiskSpace
Behandeln Sie die Liste des Speicherplatzes.
[in, out] ReturnBuffer
Optionaler Zeiger auf einen Puffer, der die Laufwerkspezifikationen empfängt, z. B. "X:" oder "\server\share". Sie sollten eine null--terminated-Zeichenfolge verwenden. Die null-terminated string sollte die Größe des Zielpuffers nicht überschreiten. Dieser Parameter kann NULL-sein. Wenn dieser Parameter nicht angegeben ist und kein Fehler auftritt, gibt die Funktion einen Wert ungleich Null zurück, und RequiredSize die puffergröße empfängt, die zum Halten der Laufwerksspezifikationen erforderlich ist.
[in] ReturnBufferSize
Größe des Puffers, der durch ReturnBuffer-in Zeichen verweist. Dies schließt den null Terminator ein. Dieser Parameter wird ignoriert, wenn ReturnBuffer- nicht angegeben ist.
[in, out] RequiredSize
Optionaler Zeiger auf eine Variable, die die Größe des Puffers empfängt, der zum Speichern der NULL--terminated-Liste von Laufwerken in Zeichen erforderlich ist. Dies schließt den null Terminator ein.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Wenn die GetLastError--Funktion ERROR_INSUFFICIENT_BUFFER zurückgibt, wurde ReturnBuffer- angegeben, aber ReturnBufferSize angegeben, dass der angegebene Puffer zu klein war.
Bemerkungen
Anmerkung
Der header setupapi.h definiert SetupQueryDrivesInDiskSpaceList als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | setupapi.h |
| Library | Setupapi.lib |
| DLL- | Setupapi.dll |