Funzione SetupCopyErrorW (setupapi.h)

[Questa funzione è disponibile per l'uso nei sistemi operativi indicati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive. SetupAPI non deve più essere usata per l'installazione di applicazioni. Usare invece Windows Installer per lo sviluppo di programmi di installazione delle 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 un nullstringa con terminazione 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 nella lingua di sistema).

[in] DiskName

Puntatore facoltativo a un nullstringa con terminazione che specifica il nome del disco da inserire.

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

[in] PathToSource

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

Usare un nullstringa con terminazione.

[in] SourceFile

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

Usare un nullstringa con terminazione. Questo nome file viene visualizzato se l'utente fa clic sui pulsanti dettagli o Sfoglia. La funzione SetupCopyError cerca il file che usa i relativi nomi di modulo compressi. Pertanto, è possibile passare cmd.exe e non preoccuparsi che il file esista effettivamente come cmd.ex_ sul supporto di origine.

[in] TargetPathFile

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

Usare un nullstringa con terminazione. Questo parametro può essere NULL. Se TargetPathFile non è specificato, viene usato "(Unknown)" (localizzato nella lingua di sistema).

[out] Win32ErrorCode

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

Se non si verifica un errore, viene 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 dei dettagli.

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

IDF_NOCOMPRESSED

Non verificare la presenza di versioni compresse del file di origine.

IDF_OEMDISK

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

IDF_NOBEEP

Impedisce all'utente di visualizzare l'attenzione della finestra di dialogo quando viene visualizzata 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 dall'utente nella finestra di dialogo. È consigliabile usare una stringa con terminazione Null.

Il nullstringa con terminazione 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 carattere di terminazione null .

[in, out] PathRequiredSize

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

Valore restituito

La funzione restituisce uno dei valori seguenti.

Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Se questa funzione viene chiamata con un PathBuffer di NULL e un 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.

Fabbisogno

Vedere anche

Funzioni

panoramica

SetupDeleteError

SetupPromptForDisk

SetupRenameError