FILEPATHS_W-Struktur (setupapi.h)

Artikel
03/04/2024

Die FILEPATHS-Struktur speichert Quell- und Zielpfadinformationen. Die Setupfunktionen senden die FILEPATHS-Struktur als Parameter in mehreren Benachrichtigungen, die an Rückrufroutinen gesendet werden. Weitere Informationen finden Sie unter Benachrichtigungen.

Syntax

typedef struct _FILEPATHS_W {
  PCWSTR Target;
  PCWSTR Source;
  UINT   Win32Error;
  DWORD  Flags;
} FILEPATHS_W, *PFILEPATHS_W;

Member

Target

Pfad zur Zieldatei.

Source

Pfad zur Quelldatei. Dieser Member wird nicht verwendet, wenn die FILEPATHS-Struktur mit einem Dateilöschvorgang verwendet wird.

Win32Error

Wenn ein Fehler auftritt, ist dieser Member der Systemfehlercode. Wenn kein Fehler aufgetreten ist, wird er NO_ERROR.

Flags

Zusätzliche Informationen, die von der Benachrichtigung abhängen, die mit der FILEPATHS-Struktur gesendet wird.

Für SPFILENOTIFY_COPYERRORBenachrichtigungen gibt Flags das Dialogfeldverhalten an und kann einer der folgenden Werte sein.

Wert	Bedeutung
SP_COPY_NOBROWSE	Bieten Sie dem Benutzer nicht die Option zum Durchsuchen an.
SP_COPY_NOSKIP	Bieten Sie dem Benutzer nicht die Option an, die Datei zu überspringen.
SP_COPY_WARNIFSKIP	Informieren Sie den Benutzer darüber, dass sich das Überspringen der Datei auf die Installation auswirken kann.

Für SPFILENOTIFY_FILEOPDELAYEDBenachrichtigungen gibt Flags den Typ des Dateivorgangs verzögert an und kann einer der folgenden Werte sein.

Wert	Bedeutung
FILEOP_COPY	Ein Dateikopiervorgang wurde verzögert.
FILEOP_DELETE	Ein Dateilöschvorgang wurde verzögert.

Hinweise

Hinweis

Der Setupapi.h-Header definiert FILEPATHS 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
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	setupapi.h

Weitere Informationen

Übersicht

Strukturen

Share via