Funzione SetupQueryInfFileInformationA (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 SetupQueryInfFileInformation restituisce un nome file INF da una struttura SP_INF_INFORMATION a un buffer.

Sintassi

WINSETUPAPI BOOL SetupQueryInfFileInformationA(
  [in]      PSP_INF_INFORMATION InfInformation,
  [in]      UINT                InfIndex,
  [in, out] PSTR                ReturnBuffer,
  [in]      DWORD               ReturnBufferSize,
  [in, out] PDWORD              RequiredSize
);

Parametri

[in] InfInformation

Puntatore a una struttura SP_INF_INFORMATION restituita da una chiamata alla funzione SetupGetInfInformation.

[in] InfIndex

Indice del nome file INF costitutivo da recuperare. Questo indice può essere compreso nell'intervallo [0, InfInformation.InfCount). Ciò significa che i valori da zero a, ma non inclusi, InfInformation.InfCount sono validi.

[in, out] ReturnBuffer

Se non NULL, ReturnBuffer è un puntatore a un buffer in cui questa funzione restituisce il nome file INF completo. È 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. Vedere la sezione Osservazioni. Usando questa tecnica, è possibile evitare errori a causa di dimensioni del buffer insufficienti. Questo parametro può essere NULL.

[in] ReturnBufferSize

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

[in, out] RequiredSize

Se non NULL, puntatore a una variabile che riceve le dimensioni necessarie per il buffer ReturnBuffer , in caratteri. Ciò include il carattere di terminazione null . Se viene specificato ReturnBuffer e le dimensioni effettive sono maggiori di 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

SetupGetInfInformation

SetupQueryInfVersionInformation