SetupSetDirectoryIdA-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 SetupSetDirectoryId Funktion ordnet einen Verzeichnisbezeichner in einer INF-Datei einem bestimmten Verzeichnis zu.
Syntax
WINSETUPAPI BOOL SetupSetDirectoryIdA(
[in] HINF InfHandle,
[in] DWORD Id,
[in] PCSTR Directory
);
Parameter
[in] InfHandle
Ein Handle für eine geladene INF-Datei.
[in] Id
Eine Verzeichnis-ID (DIRID), die für eine Zuordnung verwendet werden soll. Dieser Parameter kann NULL-sein. Diese DIRID muss größer oder gleich DIRID_USER sein. Wenn für diese DIRID bereits eine Zuordnung vorhanden ist, wird sie überschrieben. Wenn ID-NULL-ist, wird der parameter Directory ignoriert, und der aktuelle Satz von benutzerdefinierten DIRIDs wird gelöscht.
[in] Directory
Ein Zeiger auf eine NULL--terminated-Zeichenfolge, die den Verzeichnispfad angibt, der ID-zugeordnet werden soll. Dieser Parameter kann NULL-sein. Wenn Verzeichnis-NULL-ist, wird ein verzeichnis, das ID- zugeordnet ist, nicht zugeordnet. Keine Fehlerergebnisse, wenn ID- derzeit nicht einem Verzeichnis zugeordnet ist.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
SetupSetDirectoryId- kann vor dem Anwarteschlangen von Dateikopievorgängen verwendet werden, um einen Zielspeicherort anzugeben, der zur Laufzeit nur bekannt ist.
Nach dem Festlegen des Verzeichnisbezeichners durchläuft diese Funktion alle angefügten INF-Dateien, und wenn einer dieser Dateien nicht aufgelöste Zeichenfolgenersetzungen aufweist, versucht die Funktion, die Zeichenfolgenersetzung auf der Grundlage der neuen DIRID-Zuordnung erneut auf sie anzuwenden. Aus diesem Gründen können sich einige INF-Werte nach dem Aufrufen SetupSetDirectoryIdändern.
DIRID_ABSOLUTE_16BIT ist kein gültiger Wert für ID-, wodurch die Kompatibilität mit dem 16-Bit-Setup sichergestellt wird.
Anmerkung
Der header setupapi.h definiert SetupSetDirectoryId 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 |