Funzione SetupGetTargetPathA (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 SetupGetTargetPath determina la directory di destinazione per una sezione dell'elenco di file. La sezione dell'elenco di file può essere una sezione Copia file, una sezione Elimina file o una sezione Rinomina file. Tutti i file nella sezione devono trovarsi in una singola directory elencata in una sezione DestinationDirs del file INF.

Sintassi

WINSETUPAPI BOOL SetupGetTargetPathA(
  [in]      HINF        InfHandle,
  [in]      PINFCONTEXT InfContext,
  [in]      PCSTR       Section,
  [in, out] PSTR        ReturnBuffer,
  [in]      DWORD       ReturnBufferSize,
  [in, out] PDWORD      RequiredSize
);

Parametri

[in] InfHandle

Handle per il file INF di caricamento che contiene una sezione destinationDirs .

[in] InfContext

Puntatore facoltativo a un contesto INF che specifica una riga in una sezione dell'elenco di file la cui directory di destinazione deve essere recuperata. Se InfContext è NULL, viene utilizzato il parametro section .

[in] Section

Parametro facoltativo che specifica il nome di una sezione del file INF il cui handle è InfHandle. SetupGetTargetPath recupera la directory di destinazione per questa sezione. Il parametro Section viene ignorato se viene specificato InfContext. Se non InfContext né sezione, la funzione recupera il percorso di destinazione predefinito dal file INF. È consigliabile usare un nullstringa con terminazione.

[in, out] ReturnBuffer

Puntatore facoltativo al buffer per ricevere il percorso di destinazione completo. Il percorso non termina con . È consigliabile usare un nullstringa con terminazione. È 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. Questo parametro può essere NULL.

[in] ReturnBufferSize

Dimensioni del buffer a cui punta ReturnBuffer, in caratteri . Ciò include il carattere di terminazione null .

[in, out] RequiredSize

Puntatore facoltativo a una variabile che riceve le dimensioni necessarie per il buffer a cui punta ReturnBuffer, in caratteri . Ciò include il carattere di terminazione null . Se le dimensioni effettive necessarie sono maggiori del valore specificato da ReturnBufferSize, la funzione non riesce e una chiamata a GetLastError restituisce ERROR_INSUFFICIENT_BUFFER.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

Se questa funzione viene chiamata con un ReturnBuffer di NULL e un ReturnBufferSize pari a zero, la funzione inserisce le dimensioni del buffer necessarie per contenere i dati specificati nella variabile a cui punta RequiredSize. Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero. In caso contrario, il valore restituito è zero e è possibile ottenere informazioni estese sull'errore chiamando GetLastError.

Fabbisogno

Vedere anche

Funzioni

panoramica

SetupGetSourceFileLocation

SetupGetSourceFileSize

SetupGetSourceInfo