funzione CM_Get_Device_Interface_List_SizeW (cfgmgr32.h)

Articolo
02/23/2024

La funzione CM_Get_Device_Interface_List_Size recupera le dimensioni del buffer che devono essere passate alla funzione CM_Get_Device_Interface_List .

Sintassi

CMAPI CONFIGRET CM_Get_Device_Interface_List_SizeW(
  [out]          PULONG      pulLen,
  [in]           LPGUID      InterfaceClassGuid,
  [in, optional] DEVINSTID_W pDeviceID,
  [in]           ULONG       ulFlags
);

Parametri

[out] pulLen

Puntatore fornito dal chiamante a una posizione che riceve la lunghezza richiesta, in caratteri, di un buffer per contenere le più stringhe Unicode che verranno restituite da CM_Get_Device_Interface_List.

[in] InterfaceClassGuid

Fornisce un GUID che identifica una classe di interfaccia del dispositivo.

[in, optional] pDeviceID

Puntatore fornito dal chiamante a una stringa con terminazione NULL che rappresenta un ID istanza del dispositivo. Se specificato, la funzione recupera la lunghezza dei nomi di collegamento simbolico per le interfacce del dispositivo supportate dal dispositivo, per la classe specificata. Se questo valore è NULL o se punta a una stringa di lunghezza zero, la funzione recupera la lunghezza dei nomi di collegamento simbolico per tutte le interfacce che appartengono alla classe specificata.

[in] ulFlags

Contiene uno dei flag forniti dal chiamante seguenti:

Valore	Significato
CM_GET_DEVICE_INTERFACE_LIST_ALL_DEVICES	La funzione fornisce le dimensioni di un elenco che contiene interfacce di dispositivo associate a tutti i dispositivi che corrispondono al GUID e all'ID istanza del dispositivo specificati, se presenti.
CM_GET_DEVICE_INTERFACE_LIST_PRESENT	La funzione fornisce le dimensioni di un elenco contenente le interfacce del dispositivo associate ai dispositivi attualmente attivi e che corrispondono al GUID e all'ID istanza del dispositivo specificati, se presenti.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con il prefisso CR_ definito in Cfgmgr32.h.

Commenti

Nota

L'intestazione cfgmgr32.h definisce CM_Get_Device_Interface_List_Size 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	Universale
Intestazione	cfgmgr32.h (include Cfgmgr32.h)
Libreria	Cfgmgr32.lib
DLL	CfgMgr32.dll

Vedi anche

CM_Get_Device_Interface_List