FILEPATHS_A Struktur (setupapi.h)

Artikel
11/20/2024

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

Syntax

typedef struct _FILEPATHS_A {
  PCSTR Target;
  PCSTR Source;
  UINT  Win32Error;
  DWORD Flags;
} FILEPATHS_A, *PFILEPATHS_A;

Angehörige

Target

Pfad zur Zieldatei.

Source

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

Win32Error

Wenn ein Fehler auftritt, ist dieses Element 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_COPYERROR Benachrichtigungen gibt Flags das Verhalten des Dialogfelds 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 Möglichkeit, 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_FILEOPDELAYED Benachrichtigungen gibt Flags den Typ des verzögerten Dateivorgangs an und kann einen der folgenden Werte aufweisen.

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

Bemerkungen

Anmerkung

Der Header "setupapi.h" 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
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Header-	setupapi.h

Siehe auch

Übersicht

Strukturen

Freigeben über