SetupSetDirectoryIdExW-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 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 SetupSetDirectoryIdEx-Funktion ordnet einen Verzeichnisbezeichner in einer INF-Datei einem bestimmten Verzeichnis zu.

Syntax

WINSETUPAPI BOOL SetupSetDirectoryIdExW(
  [in] HINF   InfHandle,
  [in] DWORD  Id,
  [in] PCWSTR Directory,
  [in] DWORD  Flags,
       DWORD  Reserved1,
       PVOID  Reserved2
);

Parameter

[in] InfHandle

Ein Handle für eine geladene INF-Datei.

[in] Id

Ein Verzeichnisbezeichner (DIRID), der 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 0 ist, wird der Directory-Parameter ignoriert, und der aktuelle Satz benutzerdefinierter DIRIDs wird gelöscht.

[in] Directory

Ein Zeiger auf eine NULL-beendete Zeichenfolge, die den Verzeichnispfad angibt, der id zugeordnet werden soll. Dieser Parameter kann NULL sein. Wenn DirectoryNULL ist, wird jedes Verzeichnis, das der ID zugeordnet ist, nicht zugeordnet. Es tritt kein Fehler auf, wenn die ID derzeit nicht einem Verzeichnis zugeordnet ist.

[in] Flags

Dieser Parameter kann auf SETDIRID_NOT_FULL_PATH (1) festgelegt werden, um anzugeben, dass das Verzeichnis keinen vollständigen Pfad angibt.

Reserved1

Wenn der Wert dieses Parameters nicht 0 ist, gibt die Funktion ERROR_INVALID_PARAMETER zurück.

Reserved2

Wenn der Wert dieses Parameters nicht 0 ist, gibt die Funktion ERROR_INVALID_PARAMETER 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 0 (null). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

SetupSetDirectoryIdEx kann vor dem Anstehen von Dateikopiervorgängen verwendet werden, um einen Zielspeicherort anzugeben, der nur zur Laufzeit bekannt ist.

Nach dem Festlegen des Verzeichnisbezeichners durchläuft diese Funktion alle angefügten INF-Dateien, und wenn eine davon nicht aufgelöste Zeichenfolgenersetzungen aufweist, versucht die Funktion, die Zeichenfolgenersetzung auf sie basierend auf der neuen DIRID-Zuordnung erneut anzuwenden. Aus diesem Fall können sich einige INF-Werte ändern, nachdem SetupSetDirectoryIdEx aufgerufen wurde.

DIRID_ABSOLUTE_16BIT ist kein gültiger Wert für id, was die Kompatibilität mit dem 16-Bit-Setup sicherstellt.

Hinweis

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

Siehe auch

Funktionen

Übersicht