Funzione SetupCopyErrorW (setupapi.h)

Articolo
03/09/2024

[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. SetupAPI non deve più essere usato per l'installazione di applicazioni. Usare invece Windows Installer per lo sviluppo di programmi di installazione di applicazioni. SetupAPI continua a essere usato per l'installazione dei driver di dispositivo.

La funzione SetupCopyError genera una finestra di dialogo per notificare a un utente un errore di copia del file.

Sintassi

WINSETUPAPI UINT SetupCopyErrorW(
  [in]      HWND   hwndParent,
  [in]      PCWSTR DialogTitle,
  [in]      PCWSTR DiskName,
  [in]      PCWSTR PathToSource,
  [in]      PCWSTR SourceFile,
  [in]      PCWSTR TargetPathFile,
  [out]     UINT   Win32ErrorCode,
  [in]      DWORD  Style,
  [in, out] PWSTR  PathBuffer,
  [in]      DWORD  PathBufferSize,
  [in, out] PDWORD PathRequiredSize
);

Parametri

[in] hwndParent

Handle della finestra padre per questa finestra di dialogo.

[in] DialogTitle

Puntatore facoltativo a una stringa con terminazione null che specifica il titolo della finestra di dialogo.

Questo parametro può essere NULL. Se questo parametro è NULL, viene usato il titolo predefinito "Copia errore" (localizzato nel linguaggio di sistema).

[in] DiskName

Puntatore facoltativo a una stringa con terminazione null che specifica il nome del disco da inserire.

Questo parametro può essere NULL. Se questo parametro è NULL, viene usato il nome predefinito "(Sconosciuto)" (localizzato nel linguaggio di sistema).

[in] PathToSource

Puntatore al componente percorso del file di origine in cui un'operazione ha esito negativo, ad esempio F:\x86.

Usare una stringa con terminazione null.

[in] SourceFile

Puntatore a una stringa con terminazione null che specifica la parte del nome file del file in cui un'operazione ha esito negativo.

Usare una stringa con terminazione null. Questo nome file viene visualizzato se l'utente fa clic sui pulsanti Dettagli o Sfoglia . La funzione SetupCopyError cerca il file che usa i nomi dei moduli compressi. Pertanto, è possibile passare cmd.exe e non preoccuparsi che il file esista effettivamente come cmd.ex_ nel supporto di origine.

[in] TargetPathFile

Puntatore facoltativo a una stringa con terminazione null che specifica il percorso completo del file di destinazione per le operazioni di ridenominazione e copia.

Usare una stringa con terminazione null. Questo parametro può essere NULL. Se TargetPathFile non è specificato, viene usato "(Sconosciuto)" (localizzato nel linguaggio di sistema).

[out] Win32ErrorCode

Se si verifica un errore, questo membro è il codice errore di sistema.

Se non si verifica un errore, è NO_ERROR.

[in] Style

Flag che controllano la formattazione e il comportamento di una finestra di dialogo.

Questo parametro può essere uno dei flag seguenti.

IDF_NOBROWSE

Non visualizzare l'opzione sfoglia.

IDF_NOSKIP

Non visualizzare l'opzione ignora file.

IDF_NODETAILS

Non visualizzare l'opzione dettagli.

Se questo flag è impostato, è possibile omettere i parametri TargetPathFile e Win32ErrorCode .

IDF_NOCOMPRESSED

Non controllare le versioni compresse del file di origine.

IDF_OEMDISK

L'origine dell'operazione è un disco fornito da un produttore hardware.

IDF_NOBEEP

Impedisce il beping della finestra di dialogo per ottenere l'attenzione dell'utente quando viene visualizzato per la prima volta.

IDF_NOFOREGROUND

Impedisce alla finestra di dialogo di diventare la finestra in primo piano.

IDF_WARNIFSKIP

Avvisa l'utente che ignora un file può influire sull'installazione.

[in, out] PathBuffer

Puntatore facoltativo a una variabile in cui questa funzione restituisce il percorso (non incluso il nome file) del percorso specificato da un utente nella finestra di dialogo. È consigliabile usare una stringa con terminazione Null.

La stringa con terminazione null non deve superare le dimensioni del buffer di destinazione. Per evitare errori di buffer insufficienti, PathBuffer deve essere almeno MAX_PATH. Per altre informazioni, vedere la sezione Osservazioni di questo argomento.

[in] PathBufferSize

Dimensioni del buffer a cui PathBuffer punta, in caratteri.

Le dimensioni del buffer devono essere almeno MAX_PATH caratteri, incluso il terminatore Null .

[in, out] PathRequiredSize

Puntatore facoltativo a una variabile in cui questa funzione restituisce le dimensioni del buffer necessarie, in caratteri, incluso il terminatore Null .

Valore restituito

La funzione restituisce uno dei valori seguenti.

Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Se questa funzione viene chiamata con pathBuffer di NULL e pathBufferSize pari a 0 (zero), la funzione inserisce le dimensioni del buffer necessarie per contenere i dati specificati nella variabile a cui punta PathRequiredSize.

Se la funzione ha esito positivo, il valore restituito è NO_ERROR. In caso contrario, il valore restituito è uno dei valori specificati.

Per evitare errori di buffer insufficienti, ReturnBuffer deve essere almeno MAX_PATH.

Nota

L'intestazione setupapi.h definisce SetupCopyError come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	setupapi.h
Libreria	Setupapi.lib
DLL	Setupapi.dll