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

Siehe auch

Funktionen

Übersicht

SetupQuerySpaceRequiredOnDrive