SetupGetTargetPathA-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 SetupGetTargetPath--Funktion bestimmt das Zielverzeichnis für einen Dateilistenabschnitt. Der Dateilistenabschnitt kann ein Abschnitt "Dateien kopieren", ein Abschnitt "Dateien löschen" oder ein Abschnitt "Dateien umbenennen" sein. Alle Dateien im Abschnitt müssen sich in einem einzigen Verzeichnis befinden, das in einem DestinationDirs Abschnitt 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
Behandeln Sie das 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, deren Zielverzeichnis abgerufen werden soll. Wenn InfContext-NULL-ist, wird der parameter Section verwendet.
[in] Section
Optionaler Parameter, der den Namen eines Abschnitts der INF-Datei angibt, deren Handle InfHandle-ist. SetupGetTargetPath das Zielverzeichnis für diesen Abschnitt abruft. Der parameter Section wird ignoriert, wenn InfContext- angegeben ist. Wenn weder InfContext noch Section angegeben wird, ruft die Funktion den Standardzielpfad aus der INF-Datei ab. Sie sollten eine null--terminated-Zeichenfolge verwenden.
[in, out] ReturnBuffer
Optionaler Zeiger zum Puffer, um den vollqualifizierten Zielpfad zu empfangen. Der Pfad ist garantiert nicht enden mit . Sie sollten eine null--terminated-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. Mithilfe dieser Technik können Sie Fehler aufgrund einer unzureichenden Puffergröße vermeiden. Weitere Informationen finden Sie im Abschnitt "Hinweise". Dieser Parameter kann NULL-sein.
[in] ReturnBufferSize
Die Größe des Puffers, auf den ReturnBuffer-in Zeichen verweist. Dies schließt den null Terminator ein.
[in, out] RequiredSize
Optionaler Zeiger auf eine Variable, die die erforderliche Größe für den Puffer empfängt, auf die durch ReturnBufferin Zeichen verwiesen wird. Dies schließt den null Terminator ein. Wenn die erforderliche Größe größer als der von ReturnBufferSizeangegebene 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 fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Wenn diese Funktion mit einer ReturnBuffer- von NULL- und einer ReturnBufferSize- null aufgerufen wird, fügt die Funktion die Puffergröße ein, die zum Halten der angegebenen Daten in die Variable erforderlich ist, auf die RequiredSizeverweist. Wenn die Funktion in diesem Fall erfolgreich ausgeführt wird, ist der Rückgabewert ein Wert ungleich Null. Andernfalls ist der Rückgabewert null und erweiterte Fehlerinformationen können durch Aufrufen von GetLastErrorabgerufen werden.
Anmerkung
Der Header "setupapi.h" 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 |
|---|---|
| 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 |