Funzione SetupPromptForDiskA (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 SetupPromptForDisk visualizza una finestra di dialogo che richiede all'utente un disco.

Sintassi

WINSETUPAPI UINT SetupPromptForDiskA(
  [in]      HWND   hwndParent,
  [in]      PCSTR  DialogTitle,
  [in]      PCSTR  DiskName,
  [in]      PCSTR  PathToSource,
  [in]      PCSTR  FileSought,
  [in]      PCSTR  TagFile,
  [in]      DWORD  DiskPromptStyle,
  [in, out] PSTR   PathBuffer,
  [in]      DWORD  PathBufferSize,
  [in, out] PDWORD PathRequiredSize
);

Parametri

[in] hwndParent

Handle nella finestra padre per questa finestra di dialogo.

[in] DialogTitle

Puntatore facoltativo a un nullstringa con terminazione specificando il titolo della finestra di dialogo. Se questo parametro è NULL, viene usato il valore predefinito ""%s--Files Needed"" (localizzato). "%s" viene sostituito con il testo recuperato dalla finestra padre. Se non viene recuperato alcun testo dalla finestra padre, il titolo è "File necessari".

[in] DiskName

Puntatore facoltativo a un nullstringa con terminazione specificando il nome del disco da inserire. Se questo parametro è NULL, viene usato il valore predefinito "(Unknown)" (localizzato).

[in] PathToSource

Puntatore facoltativo a un nullstringa con terminazione specificando la parte del percorso previsto del file, ad esempio F:\x86. Se non specificato, viene usato il percorso in cui SetupPromptForDisk più di recente che si trova un file. Se l'elenco è vuoto, viene utilizzato un valore predefinito di sistema.

[in] FileSought

Puntatore a un nullstringa con terminazione specificando il nome del file necessario (solo parte del nome file). Il nome file viene visualizzato se l'utente fa clic sul pulsante sfoglia . Questa routine cerca il file usando 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] TagFile

Puntatore facoltativo a un nullstringa con terminazione specificando un file di tag (solo parte del nome file) che identifica la presenza di un particolare volume multimediale rimovibile. Se il percorso attualmente selezionato inserisce il file su supporti rimovibili e viene specificato un file di tag, SetupPromptForDisk cerca il file di tag nella radice dell'unità per determinare se continuare.

Ad esempio, se PathToSource è A:\x86, il tagfile è disk1.tag e l'utente digita B:\x86 nel controllo di modifica della finestra di dialogo di richiesta, la routine cerca B:\disk1.tag per determinare se continuare. Se il file di tag non viene trovato, la funzione cerca il tagfile usando PathToSource.

Se non si specifica un file di tag, i supporti rimovibili funzionano come supporti non rimovibili e FileSought viene cercato prima di continuare.

[in] DiskPromptStyle

Specifica il comportamento della finestra di dialogo. Questo parametro può essere una combinazione dei flag seguenti.

IDF_CHECKFIRST

Verificare la presenza del file o del disco prima di visualizzare la finestra di dialogo di richiesta e, se presente, restituire immediatamente DPROMPT_SUCCESS.

IDF_NOBEEP

Impedire che la finestra di dialogo si avaghi per ottenere l'attenzione dell'utente quando viene visualizzata per la prima volta.

IDF_NOBROWSE

Non visualizzare l'opzione sfoglia.

IDF_NOCOMPRESSED

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

IDF_NODETAILS

Non visualizzare informazioni dettagliate.

IDF_NOFOREGROUND

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

IDF_NOSKIP

Non visualizzare l'opzione skip.

IDF_OEMDISK

Richiedere un disco fornito da un produttore hardware.

IDF_WARNIFSKIP

Avvisare l'utente che ignorare un file può influire sull'installazione.

[in, out] PathBuffer

Puntatore facoltativo a un buffer che, al momento della restituzione, riceve il percorso (nessun nome file) della posizione specificata dall'utente tramite la finestra di dialogo. È consigliabile usare un nullstringa con terminazione. Il nullstringa con terminazione non deve superare le dimensioni del buffer di destinazione. È possibile chiamare la funzione una volta per ottenere le dimensioni del buffer necessarie, allocare la memoria necessaria e quindi chiamare la funzione una seconda volta per recuperare i dati. Usando questa tecnica, è possibile evitare errori a causa di dimensioni del buffer insufficienti. Vedere la sezione Osservazioni.

[in] PathBufferSize

Dimensioni del buffer a cui punta PathBuffer, in caratteri . Dovrebbe essere almeno MAX_PATH lungo. Ciò include il carattere di terminazione null .

[in, out] PathRequiredSize

Puntatore facoltativo a una variabile che riceve le dimensioni necessarie per PathBuffer, in caratteri. Ciò include il carattere di terminazione null .

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 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 descritti nella sezione Valori restituiti.

Fabbisogno

Vedere anche

Funzioni

panoramica

SetupCopyError

SetupDeleteError

SetupRenameError