FILEPATHS_A-Struktur (setupapi.h)

  • Artikel

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_A {
  PCSTR Target;
  PCSTR Source;
  UINT  Win32Error;
  DWORD Flags;
} FILEPATHS_A, *PFILEPATHS_A;

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