SetupGetTargetPathA-Funktion (setupapi.h)

Artikel
03/04/2024

[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 SetupGetTargetPath-Funktion bestimmt das Zielverzeichnis für einen Dateilistenabschnitt. Der Abschnitt Dateiliste kann ein Abschnitt Zum Kopieren von Dateien , zum Löschen von Dateien oder zum Umbenennen von Dateien verwendet werden. Alle Dateien im Abschnitt müssen sich in einem einzelnen Verzeichnis befinden, das in einem Abschnitt DestinationDirs der INF-Datei aufgeführt ist.

Syntax

WINSETUPAPI BOOL SetupGetTargetPathA(
  [in]      HINF        InfHandle,
  [in]      PINFCONTEXT InfContext,
  [in]      PCSTR       Section,
  [in, out] PSTR        ReturnBuffer,
  [in]      DWORD       ReturnBufferSize,
  [in, out] PDWORD      RequiredSize
);

Parameter

[in] InfHandle

Handle mit der LADE-INF-Datei, die einen DestinationDirs-Abschnitt enthält.

[in] InfContext

Optionaler Zeiger auf einen INF-Kontext, der eine Zeile in einem Dateilistenabschnitt angibt, deren Zielverzeichnis abgerufen werden soll. Wenn InfContextNULL ist, wird der Section-Parameter verwendet.

[in] Section

Optionaler Parameter, der den Namen eines Abschnitts der INF-Datei angibt, dessen Handle InfHandle lautet. SetupGetTargetPath ruft das Zielverzeichnis für diesen Abschnitt ab. Der Section-Parameter wird ignoriert, wenn InfContext angegeben wird. Wenn weder InfContext noch Section angegeben ist, ruft die Funktion den Standardzielpfad aus der INF-Datei ab. Sie sollten eine NULL-Zeichenfolge verwenden.

[in, out] ReturnBuffer

Optionaler Zeiger auf puffern, um den vollqualifizierten Zielpfad zu empfangen. Der Pfad endet garantiert nicht mit . Sie sollten eine NULL-Zeichenfolge verwenden. Sie können die Funktion einmal aufrufen, um die erforderliche Puffergröße abzurufen, den erforderlichen Arbeitsspeicher zuzuweisen und die Funktion dann ein zweites Mal aufzurufen, um die Daten abzurufen. Mit diesem Verfahren können Sie Fehler aufgrund einer unzureichenden Puffergröße vermeiden. Weitere Informationen finden Sie im Abschnitt mit den Hinweisen. Dieser Parameter kann NULL sein.

[in] ReturnBufferSize

Größe des Puffers, auf den returnBuffer in Zeichen verweist. Dies schließt den NULL-Abschlussator ein.

[in, out] RequiredSize

Optionaler Zeiger auf eine Variable, die die erforderliche Größe für den Puffer empfängt, auf den ReturnBuffer in Zeichen verweist. Dies schließt den NULL-Abschlussator ein. Wenn die tatsächliche erforderliche Größe größer als der von ReturnBufferSize angegebene Wert ist, schlägt die Funktion fehl, und ein Aufruf von GetLastError gibt ERROR_INSUFFICIENT_BUFFER zurück.

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.

Hinweise

Wenn diese Funktion mit einem ReturnBuffer von NULL und einer ReturnBufferSize von null aufgerufen wird, legt die Funktion die Puffergröße, die zum Halten der angegebenen Daten erforderlich ist, in die Variable ein, auf die von RequiredSize verwiesen wird. Wenn die Funktion in dieser Funktion erfolgreich ist, ist der Rückgabewert ein Nonzero-Wert. Andernfalls ist der Rückgabewert null, und erweiterte Fehlerinformationen können durch Aufrufen von GetLastError abgerufen werden.

Hinweis

Der setupapi.h-Header definiert SetupGetTargetPath 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