SetupSetDirectoryIdExA-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 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

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.

Anforderungen

Siehe auch

Funktionen

Übersicht