SetupCopyOEMInfA-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 SetupCopyOEMInf-Funktion kopiert eine angegebene INF-Datei in das Verzeichnis %windir%/Inf.

Ein Aufrufer dieser Funktion muss über Administratorrechte verfügen, andernfalls schlägt die Funktion fehl.

Syntax

WINSETUPAPI BOOL SetupCopyOEMInfA(
  [in]            PCSTR  SourceInfFileName,
  [in]            PCSTR  OEMSourceMediaLocation,
  [in]            DWORD  OEMSourceMediaType,
  [in]            DWORD  CopyStyle,
  [out, optional] PSTR   DestinationInfFileName,
  [in]            DWORD  DestinationInfFileNameSize,
  [out, optional] PDWORD RequiredSize,
  [out, optional] PSTR   *DestinationInfFileNameComponent
);

Parameter

[in] SourceInfFileName

Vollständiger Pfad zur INF-Quelldatei. Sie sollten eine NULL-Zeichenfolge verwenden. Dieser Pfad sollte MAX_PATH größe nicht überschreiten, einschließlich des beendenden NULL.

[in] OEMSourceMediaLocation

Quellspeicherortinformationen, die in der vorkompilierten .inf (.pnf) gespeichert werden sollen. Diese Speicherortinformationen sind spezifisch für den angegebenen Quellmedientyp. Sie sollten eine NULL-Zeichenfolge verwenden. Dieser Pfad sollte MAX_PATH größe nicht überschreiten, einschließlich des beendenden NULL.

[in] OEMSourceMediaType

Quellmedientyp, auf den durch die Standortinformationen verwiesen wird. Dieser Parameter kann einer der folgenden Werte sein.

[in] CopyStyle

Gibt an, wie die INF-Datei in das VERZEICHNIS .inf kopiert wird. Die folgenden Flags können kombiniert werden.

[out, optional] DestinationInfFileName

Zeiger auf einen Puffer, um den Namen der INF-Datei zu erhalten, der ihm zum Zeitpunkt des Kopierens in das Inf-Verzeichnis zugewiesen wurde. Der Puffer sollte, sofern angegeben, in der Regel MAX_PATH lang sein. Wenn das SP_COPY_NOOVERWRITE-Flag angegeben ist und die SetupCopyOEMInf-Funktion mit einem Rückgabecode von ERROR_FILE_EXISTS fehlschlägt, enthält dieser Puffer den Namen der vorhandenen INF-Datei. Wenn das SP_COPY_OEMINF_CATALOG_ONLY-Flag angegeben ist, enthält dieser Puffer den Zieldateinamen .inf, wenn die INF-Datei bereits im Inf-Verzeichnis vorhanden ist. Andernfalls wird dieser Puffer auf die leere Zeichenfolge festgelegt. Dieser Parameter kann NULL sein.

[in] DestinationInfFileNameSize

Größe des DestinationInfFileName-Puffers in Zeichen oder null, wenn der Puffer nicht angegeben ist. Wenn DestinationInfFileName angegeben ist und diese Puffergröße kleiner als die Größe ist, die erforderlich ist, um den .inf-Zieldateinamen zurückzugeben (einschließlich des vollständigen Pfads), schlägt diese Funktion fehl. In diesem Fall gibt GetLastError ERROR_INSUFFICIENT_BUFFER zurück.

[out, optional] RequiredSize

Zeiger auf eine Variable, die die Größe (in Zeichen) empfängt, die erforderlich ist, um den Ziel-INF-Dateinamen zu speichern, einschließlich eines beendenden NULL. Wenn das flag SP_COPY_OEMINF_CATALOG_ONLY angegeben ist, erhält diese Variable nur dann eine Zeichenfolgenlänge, wenn die INF-Datei bereits im Inf-Verzeichnis vorhanden ist. Andernfalls wird diese Variable auf 0 festgelegt. Dieser Parameter kann NULL sein.

[out, optional] DestinationInfFileNameComponent

Zeiger auf eine Zeichenfolge, die bei erfolgreicher Rückgabe (oder ERROR_FILE_EXISTS) so festgelegt wird, dass sie auf den Anfang der Dateinamenkomponente des Pfads verweist, der im Parameter DestinationInfFileName gespeichert ist. Wenn das SP_COPY_OEMINF_CATALOG_ONLY-Flag angegeben ist, kann der Parameter DestinationInfFileName eine leere Zeichenfolge sein. In diesem Fall wird der Zeichenzeiger bei erfolgreicher Rückgabe auf NULL festgelegt. Dieser Parameter kann NULL sein.

Rückgabewert

Diese Funktion gibt WINSETUPAPI BOOL zurück.

Hinweise

Die SetupCopyOEMInf-Funktion kopiert eine angegebene INF-Datei in das Verzeichnis %windir%\Inf. SetupCopyOEMInf wird die Datei nicht erneut kopieren, wenn festgestellt wird, dass im Inf-Verzeichnis bereits ein binäres Image der angegebenen INF-Datei mit demselben Namen oder einem Namen des Formulars OEM*.inf vorhanden ist. Wenn SetupCopyOEMInf eine Datei kopiert, wird die kopierte Datei in OEM*.inf umbenannt. Der angegebene Name ist eindeutig und kann nicht vorhergesagt werden.

SetupCopyOEMInf verwendet das folgende Verfahren, um zu ermitteln, ob die INF-Datei bereits im Inf-Verzeichnis vorhanden ist:

Alle .inf-Dateien mit den Namen des Formulars OEM*.inf werden aufgelistet, und alle Dateien, die die gleiche Dateigröße wie die angegebene INF-Datei aufweisen, sind binär verglichen.

Das Inf-Verzeichnis wird nach dem Quelldateinamen der INF-Datei durchsucht. Wenn eine INF-Datei mit demselben Namen vorhanden ist und die gleiche Größe wie die angegebene INF-Datei aufweist, sind die beiden Dateien binär, um festzustellen, ob sie identisch sind.

Wenn die angegebene INF-Datei bereits vorhanden ist, wird eine weitere Überprüfung durchgeführt, um festzustellen, ob die angegebene INF-Datei im Abschnitt [Version] einen CatalogFile=-Eintrag enthält. Wenn dies der Fall ist, wird der primäre Dateiname der INF-Datei %windir%\Inf mit der Erweiterung ".cat" verwendet, um zu ermitteln, ob der Katalog bereits installiert ist. Wenn ein Katalog installiert ist, er aber nicht mit dem Katalog identisch ist, der der .inf-Quelle zugeordnet ist, wird dies nicht als Übereinstimmung betrachtet, und die Enumerationen werden fortgesetzt. Es ist möglich, mehrere identische INF-Dateien mit eindeutigen Katalogen im Verzeichnis %windir%\Inf zu haben. Wenn keine vorhandene Übereinstimmung gefunden wird, werden die INF- und CAT-Dateien unter einem neuen und eindeutigen Namen installiert.

OEM-INF-Dateien, die keinen CatalogFile=-Eintrag angeben, gelten in Bezug auf die Überprüfung der digitalen Signatur als ungültig.

In Fällen, in denen die INF-Datei in das Verzeichnis %windir%\Inf kopiert werden muss, werden alle Fehler bei der Überprüfung der digitalen Signatur gemeldet.

Wenn die INF- und CAT-Dateien bereits vorhanden sind, werden diese vorhandenen Dateinamen verwendet, und das Dateiersetzungsverhalten basiert auf den angegebenen CopyStyle-Flags. Das Ersetzungsverhalten bezieht sich nur auf die In der pnf gespeicherten Quellmedieninformationen. Vorhandene INF-, PNF- und CAT-Dateien werden nicht geändert.

Anforderungen

Siehe auch

Funktionen

Übersicht

SetupUninstallOEMInf