SetupGetTargetPathW-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 zum Installieren von Anwendungen verwendet werden. Verwenden Sie stattdessen den Windows Installer zum Entwickeln von Installationsprogrammen für Anwendungen. 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 "Dateien kopieren" , " Dateien löschen " oder " Dateien umbenennen " sein. 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 SetupGetTargetPathW(
[in] HINF InfHandle,
[in] PINFCONTEXT InfContext,
[in] PCWSTR Section,
[in, out] PWSTR ReturnBuffer,
[in] DWORD ReturnBufferSize,
[in, out] PDWORD RequiredSize
);
Parameter
[in] InfHandle
Handle zum Laden der INF-Datei, die einen DestinationDirs-Abschnitt enthält.
[in] InfContext
Optionaler Zeiger auf einen INF-Kontext, der eine Zeile in einem Dateilistenabschnitt angibt, dessen 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 ist. SetupGetTargetPath ruft das Zielverzeichnis für diesen Abschnitt ab. Der Section-Parameter wird ignoriert, wenn InfContext angegeben ist. Wenn weder InfContext noch Section angegeben ist, ruft die Funktion den Standardzielpfad aus der INF-Datei ab. Sie sollten eine NULL-endende Zeichenfolge verwenden.
[in, out] ReturnBuffer
Optionaler Zeiger auf den Puffer, um den vollqualifizierten Zielpfad zu empfangen. Der Pfad endet garantiert nicht mit . Sie sollten eine NULL-endende Zeichenfolge verwenden. Sie können die Funktion einmal aufrufen, um die erforderliche Puffergröße abzurufen, den erforderlichen Arbeitsspeicher zuzuweisen und dann die Funktion ein zweites Mal aufzurufen, um die Daten abzurufen. Mit dieser Technik können Sie Fehler vermeiden, die auf eine unzureichende Puffergröße zurückzuführen sind. Weitere Informationen finden Sie im Abschnitt mit den Hinweisen. Dieser Parameter kann NULL sein.
[in] ReturnBufferSize
Größe des Puffers, auf den von ReturnBuffer in Zeichen verwiesen wird. Dies schließt den NULL-Abschlusszeichen 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-Abschlusszeichen 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 Wert ungleich null.
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 einem ReturnBufferSize-Wert von 0 (null) aufgerufen wird, fügt die Funktion die zum Halten der angegebenen Daten erforderliche Puffergröße in die Variable ein, auf die von RequiredSize verwiesen wird. Wenn dies für die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich Null. 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 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 |
---|---|
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
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für