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 specificata.

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, in caratteri, è 254.

[in, optional] AlternatePlatformInfo

Puntatore, se non NULL, a una struttura SP_ALTPLATFORM_INFO . Questa struttura viene usata 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 impostare i relativi membri come indicato di seguito:

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 usato.

MinorVersion

non usata.

ProcessorArchitecture

Impostare una delle costanti dell'architettura del processore seguenti.

Riservato

Imposta su zero.

[out, optional] InfSectionWithExt

Puntatore a un buffer di caratteri per ricevere il nome della sezione DDInstall , l'estensione della piattaforma e un terminatore 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, necessaria per restituire il nome della sezione DDInstall , l'estensione della piattaforma e un carattere NULL terminante.

[in] InfSectionWithExtSize

Dimensioni, in caratteri, del buffer a cui punta il parametro InfSectionWithExt . La lunghezza massima di un nome di sezione INF con terminazione NULL, 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 terminante.

[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 esclusivamente per uso interno. Deve essere impostato su NULL.

Valore restituito

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

Commenti

SetupDiGetActualSectionToInstallEx è una forma estesa di SetupDiGetActualSectionToInstall. Queste funzioni supportano le estensioni ai nomi di sezione DDInstall 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 prima nel file INF specificato un nome di sezione installato 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.

Requisiti

Vedi anche

Sezione INF DDInstall

SetupDiGetActualSectionToInstallEx

SetupDiInstallDevice