Funzione SetupDiGetActualSectionToInstallExA (setupapi.h)

La funzione SetupDiGetActualSectionToInstallEx recupera il nome della sezione INF DDInstall che installa un dispositivo per un sistema operativo e un'architettura del processore specificati.

Sintassi

WINSETUPAPI BOOL SetupDiGetActualSectionToInstallExA(
  [in]            HINF                 InfHandle,
  [in]            PCSTR                InfSectionName,
  [in, optional]  PSP_ALTPLATFORM_INFO AlternatePlatformInfo,
  [out, optional] PSTR                 InfSectionWithExt,
  [in]            DWORD                InfSectionWithExtSize,
  [out, optional] PDWORD               RequiredSize,
  [out, optional] PSTR                 *Extension,
                  PVOID                Reserved
);

Parametri

[in] InfHandle

Handle per il file INF che contiene la sezione DDInstall .

[in] InfSectionName

Puntatore al nome della sezione DDInstall (come specificato in una sezione modelli INF ). La lunghezza massima del nome della sezione, espressa in caratteri, è 254.

[in, optional] AlternatePlatformInfo

Puntatore, se nonNULL, a una struttura di SP_ALTPLATFORM_INFO. Questa struttura viene utilizzata per specificare un sistema operativo e un'architettura del processore diversa da quella nel computer locale. Per restituire il nome della sezione DDInstall per il computer locale, impostare questo parametro su NULL. In caso contrario, specificare una struttura SP_ALTPLATFORM e impostarne i membri nel modo seguente:

cbSize

Impostare sulle dimensioni, in byte, di una struttura SP_ALTPLATFORM_INFO.

Piattaforma

Impostare su VER_PLATFORM_WIN32_NT per Windows XP e versioni successive di Windows.

MajorVersion

Non utilizzato.

MinorVersion

Non utilizzato.

ProcessorArchitecture

Impostare una delle costanti dell'architettura del processore seguenti.

Riservato

Impostare su zero.

[out, optional] InfSectionWithExt

Puntatore a un buffer di caratteri per ricevere il nome della sezione DDInstall, l'estensione della piattaforma e un carattere di terminazione NULL. Si tratta del nome della sezione decorata che deve essere usato per l'installazione. Se questo parametro è NULL, la funzione restituisce TRUE e imposta RequiredSize sulle dimensioni, in caratteri, necessario per restituire il nome della sezione DDInstall, l'estensione della piattaforma e un carattere NULL di terminazione.

[in] InfSectionWithExtSize

Dimensione, in caratteri, del buffer a cui punta il parametro InfSectionWithExt. La lunghezza massima di un nome di sezione INF con terminazione NULL, espressa in caratteri, è MAX_INF_SECTION_NAME_LENGTH.

[out, optional] RequiredSize

Puntatore alla variabile che riceve le dimensioni, in caratteri, necessaria per restituire il nome della sezione DDInstall, l'estensione della piattaforma e un carattere NULL di terminazione.

[out, optional] Extension

Puntatore a una variabile che riceve un puntatore al carattere '.' che contrassegna l'inizio dell'estensione nel buffer InfSectionWithExt. Se il buffer InfSectionWithExt non viene fornito o è troppo piccolo, questo parametro non è impostato. Impostare questo parametro su NULL se non è necessario un puntatore all'estensione.

Reserved

Riservato solo per uso interno. Deve essere impostato su NULL.

Valore restituito

Se la funzione ha esito positivo, restituisce TRUE. In caso contrario, restituisce FALSE. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

SetupDiGetActualSectionToInstallEx è una forma estesa di SetupDiGetActualSectionToInstall. Queste funzioni supportano le estensioni per DDInstall nomi di sezione usati per specificare azioni di installazione specifiche del sistema operativo e specifiche dell'architettura per un dispositivo. Per informazioni su queste estensioni, vedere Creazione di file INF per più piattaforme e sistemi operativi.

Se non si forniscono informazioni sulla piattaforma alternative con una chiamata a SetupDiGetActualSectionToInstallEx, la funzione esegue la stessa operazione di SetupDiGetActualSectionToInstall. Quest'ultima funzione cerca il nome della sezione di installazione specificata usando le informazioni sulla piattaforma per il computer locale.

Se si forniscono informazioni sulla piattaforma alternative con una chiamata a SetupDiGetActualSectionToInstallEx, la funzione esegue le operazioni seguenti:

• Se si specifica una piattaforma di VER_PLATFORM_WIN32_NT, la funzione cerca innanzitutto nel file INF specificato un nome di sezione di installazione decorato che corrisponde al nome, al sistema operativo e all'architettura del processore specificata. Se, ad esempio, si specifica un nome di sezione di installazione di InstallSec, la funzione cerca uno dei nomi decorati seguenti, a seconda dell'architettura del processore specificata:
  • Se si specifica l'architettura del processore basata su x86, la funzione cerca il nome decorato InstallSec.ntx86.
  • Se si specifica l'architettura del processore basata su x64, la funzione cerca il nome decorato InstallSec.ntamd64.
  • Se si specifica l'architettura del processore basata su Itanium, la funzione cerca il nome decorato InstallSec.ntia64.

  Se la funzione trova una corrispondenza per il nome, il sistema operativo e l'architettura del processore, termina la ricerca e restituisce il nome decorato corrispondente. Se la funzione non trova una corrispondenza di questo tipo, la funzione cerca una sezione il cui nome è InstallSec.nt. Se la funzione trova una corrispondenza per InstallSec.nt, termina la ricerca e restituisce questo nome. Se la funzione non trova una corrispondenza per una delle ricerche precedenti, restituisce InstallSec, ma non verifica che il file INF contenga una sezione di installazione il cui nome è InstallSec.

Fabbisogno

Vedere anche

sezione INF DDInstall

SetupDiGetActualSectionToInstallEx

SetupDiInstallDevice