SetupQueueCopySectionA-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 SetupQueueCopySection-Funktion platziert alle Dateien in einem Abschnitt einer INF-Datei in einer Setupwarteschlange zum Kopieren. Der Abschnitt muss das richtige Format für Kopierdateien aufweisen, und die INF-Datei muss die Abschnitte SourceDisksFiles undSourceDisksNames enthalten (oder die INF-Dateien, die diese Abschnitte enthalten, angefügt haben).

Syntax

WINSETUPAPI BOOL SetupQueueCopySectionA(
  [in] HSPFILEQ QueueHandle,
  [in] PCSTR    SourceRootPath,
  [in] HINF     InfHandle,
  [in] HINF     ListInfHandle,
  [in] PCSTR    Section,
  [in] DWORD    CopyStyle
);

Parameter

[in] QueueHandle

Behandeln Sie eine Setupdateiwarteschlange, wie sie von SetupOpenFileQueue zurückgegeben wird.

[in] SourceRootPath

Zeiger auf eine NULL-Zeichenfolge, die den Stamm der Quelle für diese Kopie angibt, z. B. A:.

[in] InfHandle

Behandeln Sie eine geöffnete INF-Datei, die die Abschnitte SourceDisksFiles und SourceDisksNames enthält. Wenn ListInfHandle nicht angegeben ist, enthält InfHandle die Abschnittsnamen. Wenn plattformspezifische Abschnitte für das System des Benutzers vorhanden sind (z. B. SourceDisksNames.x86 und SourceDisksFiles.x86), wird der plattformspezifische Abschnitt verwendet.

[in] ListInfHandle

Optionales Handle für eine geöffnete INF-Datei, die den Abschnitt enthält, der zum Kopieren in die Warteschlange eingereiht werden soll. Wenn ListInfHandle nicht angegeben ist, wird davon ausgegangen, dass InfHandle den Abschnitt enthält.

[in] Section

Zeiger auf eine NULL-beendete Zeichenfolge, die den Namen des Abschnitts angibt, der für die Kopie in die Warteschlange gestellt werden soll.

[in] CopyStyle

Flags, die das Verhalten des Dateikopiervorgangs steuern. Diese Flags können eine Kombination der folgenden Werte sein.

SP_COPY_DELETESOURCE

Löschen Sie die Quelldatei nach erfolgreicher Kopie. Der Aufrufer wird nicht benachrichtigt, wenn beim Löschen ein Fehler auftritt.

SP_COPY_REPLACEONLY

Kopieren Sie die Datei nur, wenn dadurch eine Datei im Zielpfad überschrieben würde.

SP_COPY_NEWER_OR_SAME

Überprüfen Sie jede kopierte Datei, um festzustellen, ob ihre Versionsressourcen darauf hinweisen, dass sie entweder gleich in der Version oder nicht neuer als eine vorhandene Kopie auf dem Ziel ist.

Die bei Versionsüberprüfungen verwendeten Dateiversionsinformationen sind die in den Membern dwFileVersionMS und dwFileVersionLS einer VS_FIXEDFILEINFO Struktur angegeben, die von den Versionsfunktionen ausgefüllt werden. Wenn eine der Dateien keine Versionsressourcen enthält oder identische Versionsinformationen enthält, wird die Quelldatei als neuer betrachtet.

Wenn die Quelldatei in version oder neuer nicht gleich ist und CopyMsgHandler angegeben ist, wird der Aufrufer benachrichtigt und kann die Kopie abbrechen. Wenn CopyMsgHandler nicht angegeben ist, wird die Datei nicht kopiert.

SP_COPY_NEWER_ONLY

Überprüfen Sie jede kopierte Datei, um festzustellen, ob ihre Versionsressourcen darauf hinweisen, dass sie nicht neuer als eine vorhandene Kopie auf dem Ziel ist. Wenn die Quelldatei neuer ist, aber in der Version des vorhandenen Ziels nicht gleich ist, wird die Datei kopiert.

SP_COPY_NOOVERWRITE

Überprüfen Sie, ob die Zieldatei vorhanden ist, und benachrichtigen Sie in diesem Fall den Aufrufer, der möglicherweise ein Veto gegen die Kopie einlegt. Wenn CopyMsgHandler nicht angegeben ist, wird die Datei nicht überschrieben.

SP_COPY_NODECOMP

Dekomprimieren Sie die Datei nicht. Wenn dieses Flag festgelegt ist, erhält die Zieldatei nicht die unkomprimierte Form des Quellnamens (falls zutreffend). Das Kopieren von f:\x86s\cmd.ex_ in \install\temp führt beispielsweise zu einer Zieldatei von \install\temp\cmd.ex_. Wenn das SP_COPY_NODECOMP-Flag nicht angegeben wurde, würde die Datei dekomprimiert und das Ziel \install\temp\cmd.exe aufgerufen. Der Dateiname-Teil von DestinationName wird, sofern angegeben, entfernt und durch den Dateinamen der Quelldatei ersetzt. Wenn SP_COPY_NODECOMP angegeben ist, können keine Sprach- oder Versionsinformationen überprüft werden.

SP_COPY_LANGUAGEAWARE

Überprüfen Sie jede kopierte Datei, um festzustellen, ob sich ihre Sprache von der Sprache einer vorhandenen Datei unterscheidet, die bereits auf dem Ziel vorhanden ist. Wenn dies der Grund ist und CopyMsgHandler angegeben ist, wird der Aufrufer benachrichtigt und kann die Kopie abbrechen. Wenn CopyMsgHandler nicht angegeben ist, wird die Datei nicht kopiert.

SP_COPY_SOURCE_ABSOLUTE

SourceFile ist ein vollständiger Quellpfad. Suchen Sie es nicht im Abschnitt SourceDisksNames der INF-Datei.

SP_COPY_SOURCEPATH_ABSOLUTE

SourcePathRoot ist der vollständige Pfadteil der Quelldatei. Ignorieren Sie die relative Quelle, die im Abschnitt SourceDisksNames der INF-Datei für das Quellmedium angegeben ist, in dem sich die Datei befindet. Dieses Flag wird ignoriert, wenn SP_COPY_SOURCE_ABSOLUTE angegeben ist.

SP_COPY_FORCE_IN_USE

Wenn das Ziel vorhanden ist, verhalten Sie sich so, als ob es verwendet wird, und stellen Sie die Datei zum Kopieren beim nächsten Systemneustart in die Warteschlange.

SP_COPY_IN_USE_NEEDS_REBOOT

Wenn die Datei während des Kopiervorgangs verwendet wurde, benachrichtigen Sie den Benutzer darüber, dass das System neu gestartet werden muss.

SP_COPY_NOSKIP

Geben Sie dem Benutzer nicht die Möglichkeit, eine Datei zu überspringen.

SP_COPY_FORCE_NOOVERWRITE

Überprüfen Sie, ob die Zieldatei vorhanden ist, und wenn ja, wird die Datei nicht überschrieben. Der Anrufer wird nicht benachrichtigt.

SP_COPY_FORCE_NEWER

Überprüfen Sie jede kopierte Datei, um festzustellen, ob ihre Versionsressourcen (oder Zeitstempel für Nicht-Bilddateien) darauf hinweisen, dass sie nicht neuer als eine vorhandene Kopie auf dem Ziel ist. Wenn die kopierte Datei nicht neuer ist, wird die Datei nicht kopiert. Der Anrufer wird nicht benachrichtigt.

SP_COPY_WARNIFSKIP

Wenn der Benutzer versucht, eine Datei zu überspringen, warnen Sie, dass sich das Überspringen einer Datei auf die Installation auswirken kann. (Wird für systemkritische Dateien verwendet.)

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Nichtzero-Wert.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn ein UNC-Verzeichnis als Zielverzeichnis eines Dateikopiervorgangs angegeben wird, müssen Sie sicherstellen, dass es vorhanden ist, bevor die Warteschlange committet wird. Die Setupfunktionen überprüfen nicht, ob UNC-Verzeichnisse vorhanden sind, und erstellen sie nicht. Wenn das UNC-Zielverzeichnis nicht vorhanden ist, schlägt die Dateikopie fehl.

Für diese Funktion ist eine Windows INF-Datei erforderlich. Einige ältere INF-Dateiformate werden möglicherweise nicht unterstützt.

Anforderungen

Siehe auch

Funktionen

Übersicht

SetupQueueCopy

SetupQueueDefaultCopy