SetupQueryDrivesInDiskSpaceListA-Funktion (setupapi.h)
[Diese Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt "Anforderungen" angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. 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 zum Installieren von Gerätetreibern verwendet.]
Die SetupQueryDrivesInDiskSpaceList-Funktion füllt einen Puffer mit einer Liste der Laufwerke, auf die von den Dateivorgängen in der Liste des Speicherplatzes verwiesen wird.
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 Laufwerksspezifikationen empfängt, z. B. "X:" oder "\server\share". Sie sollten eine NULL-Zeichenfolge verwenden. Die NULL-Zeichenfolge 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 ohne Zero zurück, und RequiredSize empfängt die Puffergröße, die zum Halten der Laufwerkspezifikationen erforderlich ist.
[in] ReturnBufferSize
Größe des Puffers, auf den ReturnBuffer verweist, in Zeichen. Dies schließt den NULL-Abschlussator 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 erforderlich ist, um die NULL-beendete Liste von Laufwerken in Zeichen zu enthalten. Dies schließt den NULL-Abschlussator ein.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Nichtzero-Wert.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Wenn die GetLastError-Funktion ERROR_INSUFFICIENT_BUFFER zurückgibt, wurde ReturnBuffer angegeben, aber ReturnBufferSize gab an, dass der angegebene Puffer zu klein war.
Hinweise
Hinweis
Der setupapi.h-Header 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 nicht codierungsneutralem Code 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | setupapi.h |
| Bibliothek | Setupapi.lib |
| DLL | Setupapi.dll |