Funzione SetupDiGetClassDevPropertySheetsW (setupapi.h)

La funzione SetupDiGetClassDevPropertySheets recupera gli handle nelle finestre delle proprietà di un elemento informazioni sul dispositivo o della classe di configurazione del dispositivo di un set di informazioni sul dispositivo.

Sintassi

WINSETUPAPI BOOL SetupDiGetClassDevPropertySheetsW(
  [in]            HDEVINFO           DeviceInfoSet,
  [in, optional]  PSP_DEVINFO_DATA   DeviceInfoData,
  [in]            LPPROPSHEETHEADERW PropertySheetHeader,
  [in]            DWORD              PropertySheetHeaderPageListSize,
  [out, optional] PDWORD             RequiredSize,
  [in]            DWORD              PropertySheetType
);

Parametri

[in] DeviceInfoSet

Handle per il set di informazioni sul dispositivo per il quale restituire handle della finestra delle proprietà. Se DeviceInfoData non specifica un elemento informazioni sul dispositivo nel set di informazioni sul dispositivo, il set di informazioni sul dispositivo deve avere una classe di configurazione del dispositivo associata.

[in, optional] DeviceInfoData

Puntatore a una struttura SP_DEVINFO_DATA che specifica un elemento informazioni sul dispositivo in DeviceInfoSet.

Questo parametro è facoltativo e può essere NULL. Se questo parametro viene specificato, SetupDiGetClassDevPropertySheets recupera gli handle delle finestre delle proprietà associati al dispositivo specificato. Se questo parametro è NULL, SetupDiGetClassDevPropertySheets recupera gli handle delle proprietà associati alla classe di installazione del dispositivo specificata in DeviceInfoSet.

[in] PropertySheetHeader

Puntatore a una struttura PROPERTYSHEETHEADER. Per informazioni sulla matrice fornita dal chiamante di handle della finestra delle proprietà associata a questa struttura, vedere la sezione Osservazioni .

Per altre informazioni su questa struttura e sulle finestre delle proprietà in generale, vedere la Microsoft Windows SDK.

[in] PropertySheetHeaderPageListSize

Numero massimo di handle che la matrice fornita dal chiamante di handle della finestra delle proprietà può contenere.

[out, optional] RequiredSize

Puntatore a una variabile di tipo DWORD che riceve il numero di finestre delle proprietà associate all'elemento informazioni sul dispositivo specificato o alla classe di configurazione del dispositivo del set di informazioni sul dispositivo specificato. Il puntatore è facoltativo e può essere NULL.

[in] PropertySheetType

Flag che indica uno dei tipi seguenti di finestre delle proprietà.

Tipo di finestra delle proprietà	Significato
DIGCDP_FLAG_ADVANCED	Finestre delle proprietà avanzate.
DIGCDP_FLAG_BASIC	Finestre delle proprietà di base. Supportato solo in Microsoft Windows 95 e Windows 98. Non usare in Windows 2000 e versioni successive di Windows.
DIGCDP_FLAG_REMOTE_ADVANCED	Finestre delle proprietà avanzate in un computer remoto.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce TRUE . In caso contrario, la funzione restituisce FALSE. Chiamare GetLastError per ottenere il codice di errore.

Commenti

Una struttura PROPERTYSHEETHEADER contiene due membri associati a una matrice fornita dal chiamante utilizzata dalla funzione per restituire gli handle delle finestre delle proprietà. Il membro phpages è un puntatore a una matrice fornita dal chiamante di handle della finestra delle proprietà e il valore di input del membro nPages specifica il numero di handle già contenuti nella matrice handle. La funzione aggiunge handle della finestra delle proprietà alla matrice handle a partire dall'elemento matrice il cui indice matrice è il valore di input di nPages. La funzione aggiunge handle alla matrice in ordine consecutivo fino a quando la matrice non è piena o gli handle di tutte le pagine della finestra delle proprietà richieste sono stati aggiunti alla matrice. Il numero massimo di handle della finestra delle proprietà che la funzione può restituire è uguale a (PropertySheetHeaderPageListSize - (valore di input di nPages)).

Se la matrice handle è sufficientemente grande da contenere gli handle di tutte le pagine della finestra delle proprietà richieste, la funzione :

• Aggiunge gli handle alla matrice handle.
• Imposta nPages sul numero totale di handle nella matrice.
• Imposta RequiredSize sul numero di handle restituiti.
• Restituisce TRUE.

Se la matrice handle non è sufficientemente grande da contenere gli handle di tutte le pagine della finestra delle proprietà specificate, la funzione :

• Aggiunge tutti gli handle che la matrice può contenere.
• Imposta nPages su PropertySheetHeaderPageListSize.
• Imposta RequiredSize sul numero totale di pagine della finestra delle proprietà richieste. Il numero di handle non restituiti dalla funzione è uguale a (RequiredSize - PropertySheetHeaderPageListSize - (valore di input di nPages)).
• Imposta il codice di errore su ERROR_INSUFFICIENT_BUFFER.
• Restituisce FALSE.

Nota

L'intestazione setupapi.h definisce SetupDiGetClassDevPropertySheets come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	setupapi.h (include Setupapi.h)
Libreria	Setupapi.lib

Vedi anche

SP_DEVINFO_DATA