SetupSetDirectoryIdExA-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 SetupSetDirectoryIdEx--Funktion ordnet einen Verzeichnisbezeichner in einer INF-Datei einem bestimmten Verzeichnis zu.
Syntax
WINSETUPAPI BOOL SetupSetDirectoryIdExA(
[in] HINF InfHandle,
[in] DWORD Id,
[in] PCSTR Directory,
[in] DWORD Flags,
DWORD Reserved1,
PVOID Reserved2
);
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.
[in] Flags
Dieser Parameter kann auf SETDIRID_NOT_FULL_PATH (1) festgelegt werden, um anzugeben, dass der Directory- keinen vollständigen Pfad angibt.
Reserved1
Wenn der Wert dieses Parameters nicht null ist, gibt die Funktion ERROR_INVALID_PARAMETER zurück.
Reserved2
Wenn der Wert dieses Parameters nicht null ist, gibt die Funktion ERROR_INVALID_PARAMETER 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 0 (null). Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
SetupSetDirectoryIdEx- 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 Fall können sich einige INF-Werte ändern, nachdem SetupSetDirectoryIdExaufgerufen wurde.
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 SetupSetDirectoryIdEx 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 |