funzione CM_Get_Device_ID_List_SizeW (cfgmgr32.h)

  • Articolo

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_SizeW(
  [out]          PULONG pulLen,
  [in, optional] PCWSTR pszFilter,
  [in]           ULONG  ulFlags
);

Parametri

[out] pulLen

Riceve un valore che rappresenta le dimensioni del buffer necessarie, in caratteri.

[in, optional] pszFilter

Puntatore fornito dal chiamante a una stringa di caratteri che specifica un subset degli identificatori dell'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 delle dimensioni fornito nella posizione a cui punta pulLen è garantito rappresentare una dimensione del buffer sufficiente per contenere tutte le stringhe di identificatore dell'istanza del dispositivo e la terminazione di NULL. Il valore fornito potrebbe effettivamente rappresentare una dimensione del buffer maggiore di quella necessaria, quindi non presupponere che il valore rappresenti la lunghezza vera 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 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 Universale
Intestazione cfgmgr32.h (include Cfgmgr32.h)
Libreria Cfgmgr32.lib
DLL CfgMgr32.dll

Vedi anche

CM_Get_Device_ID_List_Size_Ex