Funzione NetConfigurationQueryMultiString (netconfiguration.h)

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 in 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 restituisce STATUS_OBJECT_NAME_NOT_FOUND.

Osservazioni

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ò modificare questa impostazione impostando il membro ParentObject della struttura WDF_OBJECT_ATTRIBUTES.

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.21
versione minima di UMDF	2.33
intestazione	netconfiguration.h (include netadaptercx.h)
libreria	NetAdapterCxStub.lib
IRQL	PASSIVE_LEVEL