funzione CM_Get_Device_ID_List_SizeA (cfgmgr32.h)
La funzione CM_Get_Device_ID_List_Size recupera le dimensioni del buffer necessarie per contenere un elenco di ID istanza del dispositivo per le istanze del dispositivo del computer locale.
Sintassi
CMAPI CONFIGRET CM_Get_Device_ID_List_SizeA(
[out] PULONG pulLen,
[in, optional] PCSTR pszFilter,
[in] ULONG ulFlags
);
Parametri
[out] pulLen
Riceve un valore che rappresenta la dimensione del buffer richiesta, espressa in caratteri.
[in, optional] pszFilter
Puntatore fornito dal chiamante a una stringa di caratteri che specifica un subset degli identificatori di istanza del dispositivo del computer o NULL. Vedere la descrizione seguente di ulFlags.
[in] ulFlags
Uno dei flag di bit facoltativi forniti dal chiamante che specificano i filtri di ricerca. Se non vengono specificati flag, la funzione fornisce le dimensioni del buffer necessarie per contenere tutti gli identificatori di istanza per tutte le istanze del dispositivo. Per un elenco di flag di bit, vedere la descrizione ulFlags per CM_Get_Device_ID_List.
Valore restituito
Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.
Commenti
La funzione CM_Get_Device_ID_List_Size deve essere chiamata per determinare le dimensioni del buffer richieste da CM_Get_Device_ID_List.
Il valore di dimensione fornito nella posizione a cui punta pulLen è garantito che rappresenti una dimensione del buffer sufficientemente grande da contenere tutte le stringhe dell'identificatore dell'istanza del dispositivo e terminando gli NUL. Il valore fornito potrebbe effettivamente rappresentare una dimensione del buffer maggiore del necessario, quindi non presupporre che il valore rappresenti la lunghezza reale delle stringhe di caratteri che CM_Get_Device_ID_List fornire.
Per informazioni sugli ID istanza del dispositivo, vedere Stringhe di identificazione del dispositivo.
Nota
L'intestazione cfgmgr32.h definisce CM_Get_Device_ID_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
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per