Función NetConfigurationQueryBinary (netconfiguration.h)

Recupera los datos asignados actualmente a un valor del Registro especificado, almacena los datos en un búfer asignado por el marco y crea un objeto de memoria del marco para representar el búfer.

Sintaxis

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

Parámetros

[_In_] Configuration

Identificador de un objeto NETCONFIGURATION que representa una clave del Registro abierta.

[_In_] ValueName

Puntero a una estructura de UNICODE_STRING que contiene un nombre de valor.

[_In_] PoolType

Valor con tipo POOL_TYPE que especifica el tipo de memoria que se va a asignar para el búfer de datos.

[_In_opt_] MemoryAttributes

Puntero a una estructura de WDF_OBJECT_ATTRIBUTES que contiene atributos de objeto para el nuevo objeto de memoria. Este parámetro es opcional y puede ser WDF_NO_OBJECT_ATTRIBUTES.

[_Out_] Memory

Puntero a una ubicación que recibe un identificador para el nuevo objeto de memoria. El marco asigna este búfer de memoria y lo libera automáticamente cuando se cierra el objeto NETCONFIGURATION.

Valor devuelto

La función devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta función puede devolver un código de error NTSTATUS adecuado.

Comentarios

El controlador cliente obtiene un identificador para un objeto NETCONFIGURATION llamando a NetAdapterOpenConfiguration o NetConfigurationOpenSubConfiguration.

El marco libera automáticamente la memoria asignada por esta función cuando se cierra el objeto NETCONFIGURATION.

Requisitos

Requisito	Value
Plataforma de destino	Universal
Versión mínima de KMDF	1.21
Versión mínima de UMDF	2,33
Encabezado	netconfiguration.h (include netadaptercx.h)
IRQL	PASSIVE_LEVEL