struttura FILEPATHS_A (setupapi.h)

Articolo
11/20/2024

La struttura FILEPATHS archivia le informazioni sul percorso di origine e di destinazione. Le funzioni di installazione inviano la struttura FILEPATHS come parametro in diverse delle notifiche inviate alle routine di callback. Per altre informazioni, vedere Notifications.

Sintassi

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

Membri

Target

Percorso del file di destinazione.

Source

Percorso del file di origine. Questo membro non viene utilizzato quando la struttura FILEPATHS viene utilizzata con un'operazione di eliminazione file.

Win32Error

Se si verifica un errore, questo membro è il codice di errore di sistema . Se non si è verificato alcun errore, è NO_ERROR.

Flags

Informazioni aggiuntive che dipendono dalla notifica inviata con la struttura FILEPATHS.

Per le notifiche SPFILENOTIFY_COPYERROR, Flags specifica il comportamento della finestra di dialogo e può essere uno dei valori seguenti.

Valore	Significato
SP_COPY_NOBROWSE	Non offrire all'utente l'opzione di esplorazione.
SP_COPY_NOSKIP	Non offrire all'utente la possibilità di ignorare il file.
SP_COPY_WARNIFSKIP	Informare l'utente che ignorare il file può influire sull'installazione.

Per le notifiche di SPFILENOTIFY_FILEOPDELAYED, Flags specifica il tipo di operazione di file ritardata e può essere uno dei valori seguenti.

Valore	Significato
FILEOP_COPY	Un'operazione di copia file è stata ritardata.
FILEOP_DELETE	Un'operazione di eliminazione file è stata ritardata.

Osservazioni

Nota

L'intestazione setupapi.h definisce FILEPATHS come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
intestazione	setupapi.h

Vedere anche

panoramica

strutture

Condividi tramite