Funzione NetConfigurationQueryMultiString (netconfiguration.h)

Articolo
05/23/2024

Recupera la voce del Registro di sistema multistring-valued associata a un nome di valore nell'oggetto di configurazione specificato.

Sintassi

NTSTATUS NetConfigurationQueryMultiString(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *StringsAttributes,
  [_Inout_]  WDFCOLLECTION         Collection
);

Parametri

[_In_] Configuration

Handle per un oggetto NETCONFIGURATION che rappresenta una chiave del Registro di sistema aperta.

[_In_] ValueName

Puntatore a una struttura UNICODE_STRING che contiene un nome di valore nella chiave software del dispositivo.

[_In_opt_] StringsAttributes

Puntatore a una struttura WDF_OBJECT_ATTRIBUTES che contiene gli attributi forniti dal driver per i nuovi oggetti WDFSTRING. Questo parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES.

[_Inout_] Collection

Handle per un oggetto raccolta fornito dal driver. Se la funzione ha esito positivo, contiene un oggetto WDFSTRING per ogni stringa assegnata a ValueName.

Valore restituito

La funzione restituisce STATUS_SUCCESS se l'operazione ha esito positivo. Se il valore del Registro di sistema è NULL, NetConfigurationQueryMultiString restituisceSTATUS_OBJECT_NAME_NOT_FOUND.

Commenti

Il driver client ottiene un handle per un oggetto NETCONFIGURATION chiamando NetAdapterOpenConfiguration o NetConfigurationOpenSubConfiguration.

Per impostazione predefinita, le stringhe vengono padre dell'oggetto raccolta. Il driver client può modificarlo impostando il membro ParentObject della struttura WDF_OBJECT_ATTRIBUTES .

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.21
Versione UMDF minima	2.33
Intestazione	netconfiguration.h (include netadaptercx.h)
Libreria	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL

Condividi tramite