Funzione NetConfigurationQueryString (netconfiguration.h)

Recupera il valore stringa specificato dall'oggetto di configurazione dell'adattatore e assegna la stringa a un oggetto stringa framework specificato.

Sintassi

NTSTATUS NetConfigurationQueryString(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *StringAttributes,
  [_Out_]    WDFSTRING             *WdfString
);

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 per il valore stringa.

[_In_opt_] StringAttributes

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

[_Out_] WdfString

Handle per un oggetto stringa del framework. NetAdapterCx assegnerà i dati stringa del valore del Registro di sistema a questo oggetto.

Valore restituito

La funzione restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa funzione può restituire un codice di errore NTSTATUS appropriato.

Osservazioni

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

Per impostazione predefinita, l'oggetto stringa del framework è 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)
IRQL	PASSIVE_LEVEL