Funzione SetupDiGetClassDevPropertySheetsA (setupapi.h)

  • Articolo

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

Sintassi

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

Parametri

[in] DeviceInfoSet

Handle per il set di informazioni sul dispositivo per cui restituire gli handle del foglio delle proprietà. Se DeviceInfoData non specifica un elemento informazioni dispositivo nel set di informazioni sul dispositivo, il set di informazioni sul dispositivo deve avere una classe di installazione del dispositivo associata.

[in, optional] DeviceInfoData

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

Questo parametro è facoltativo e può essere NULL. Se questo parametro è specificato, SetupDiGetClassDevPropertySheets recupera gli handle dei fogli di proprietà associati al dispositivo specificato. Se questo parametro è NULL, SetupDiGetClassDevPropertySheets recupera gli handle dei fogli di 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 dei fogli di proprietà associati a questa struttura, vedere la sezione Osservazioni .

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

[in] PropertySheetHeaderPageListSize

Numero massimo di handle che la matrice fornita dal chiamante di handle del foglio di proprietà può contenere.

[out, optional] RequiredSize

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

[in] PropertySheetType

Flag che indica uno dei tipi seguenti di fogli di proprietà.

Tipo di foglio di proprietà Significato
DIGCDP_FLAG_ADVANCED Fogli delle proprietà avanzati.
DIGCDP_FLAG_BASIC Fogli 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 Fogli di proprietà avanzati in un computer remoto.

Valore restituito

La funzione restituisce TRUE se ha esito positivo. 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 che la funzione usa per restituire gli handle dei fogli delle proprietà. Il membro phpages è un puntatore a una matrice fornita dal chiamante di handle del foglio di proprietà e il valore di input del membro nPages specifica il numero di handle già contenuti nella matrice di handle. La funzione aggiunge handle del foglio delle proprietà alla matrice handle a partire dall'elemento matrice il cui indice di matrice è il valore di input di nPages. La funzione aggiunge handle alla matrice in ordine consecutivo fino a quando la matrice non è completa o gli handle di tutte le pagine del foglio delle proprietà richieste sono state aggiunte alla matrice. Numero massimo di handle del foglio di proprietà che la funzione può restituire è uguale a (PropertySheetHeaderPageListSize - (valore di input nPages)).

Se la matrice di handle è abbastanza grande per contenere gli handle di tutte le pagine del foglio delle proprietà richieste, la funzione:

  • Aggiunge gli handle alla matrice di handle.
  • Imposta nPages sul numero totale di handle nella matrice.
  • Imposta RequiredSize sul numero di handle restituiti.
  • Restituisce TRUE.
Se la matrice di handle non è sufficiente per contenere gli handle di tutte le pagine del foglio delle proprietà specificate, la funzione:
  • Aggiunge il numero di handle che la matrice può contenere.
  • Imposta nPages su PropertySheetHeaderPageListSize.
  • Imposta RequiredSize sul numero totale di pagine del foglio delle proprietà richieste. Il numero di handle non restituiti dalla funzione è uguale a (RequiredSizePropertySheetHeaderPageListSize - - (valore di input 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

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

Vedi anche

SP_DEVINFO_DATA