struttura FILEPATHS_A (setupapi.h)

Articolo
03/01/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 notifiche inviate alle routine di callback. Per altre informazioni, vedere Notifiche.

Sintassi

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

Members

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, viene NO_ERROR.

Flags

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

Per le notifiche di 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 l'opzione per ignorare il file.
SP_COPY_WARNIFSKIP	Informare l'utente che l'omissione del file può influire sull'installazione.

Per le notifiche di SPFILENOTIFY_FILEOPDELAYED , Flags specifica il tipo di operazione 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.

Commenti

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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	setupapi.h

Vedi anche

Panoramica

Strutture

Condividi tramite