Funzione NetConfigurationQueryBinary (netconfiguration.h)

  • Articolo

Recupera i dati attualmente assegnati a un valore del Registro di sistema specificato, archivia i dati in un buffer allocato dal framework e crea un oggetto memoria framework per rappresentare il buffer.

Sintassi

NTSTATUS NetConfigurationQueryBinary(
  [_In_]     NETCONFIGURATION      Configuration,
  [_In_]     PCUNICODE_STRING      ValueName,
  [_In_]     POOL_TYPE             PoolType,
  [_In_opt_] WDF_OBJECT_ATTRIBUTES *MemoryAttributes,
  [_Out_]    WDFMEMORY             *Memory
);

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.

[_In_] PoolType

Valore tipizzato POOL_TYPE che specifica il tipo di memoria da allocare per il buffer di dati.

[_In_opt_] MemoryAttributes

Puntatore a una struttura WDF_OBJECT_ATTRIBUTES che contiene gli attributi dell'oggetto per il nuovo oggetto memoria. Questo parametro è facoltativo e può essere WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] Memory

Puntatore a una posizione che riceve un handle per il nuovo oggetto memoria. Il framework alloca questo buffer di memoria e lo libera automaticamente quando l'oggetto NETCONFIGURATION viene chiuso.

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.

Commenti

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

La memoria allocata da questa funzione viene liberata automaticamente dal framework quando l'oggetto NETCONFIGURATION viene chiuso.

Requisiti

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