Función NdisOpenConfigurationKeyByName (ndis.h)

Artículo
08/07/2023

La función NdisOpenConfigurationKeyByName abre una subclave con nombre de una clave del Registro abierta determinada designada por un identificador proporcionado por el autor de la llamada.

Sintaxis

void NdisOpenConfigurationKeyByName(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  ConfigurationHandle,
  [in]  PNDIS_STRING SubKeyName,
  [out] PNDIS_HANDLE SubKeyHandle
);

Parámetros

[out] Status

Puntero a una variable proporcionada por el autor de la llamada en la que esta función devuelve el estado de su intento de abrir la clave del Registro. Los valores devueltos posibles son uno de los siguientes:

NDIS_STATUS_SUCCESS

NDIS ha inicializado el acceso a la subclave especificada por SubKeyName .

NDIS_STATUS_FAILURE

No se pudo abrir la clave.

[in] ConfigurationHandle

Identificador de una clave del Registro para la que se debe abrir una subclave. Normalmente, ConfigurationHandle lo devuelve . Función NdisOpenConfigurationEx .

[in] SubKeyName

Puntero a un tipo de NDIS_STRING que contiene una cadena de llamada proporcionada por el autor de la llamada en el juego de caracteres predeterminado del sistema que especifica el nombre de la subclave del Registro que se va a abrir. Para los controladores de Microsoft Windows 2000 y versiones posteriores, esta cadena contiene caracteres Unicode. Es decir, para Windows 2000 y versiones posteriores, NDIS define el tipo NDIS_STRING como un tipo de UNICODE_STRING .

[out] SubKeyHandle

Puntero a una variable proporcionada por el autor de la llamada en la que esta función devuelve un identificador a la subclave abierta si esta llamada se realiza correctamente.

Valor devuelto

None

Observaciones

NdisOpenConfigurationKeyByName permite que un controlador acceda a la información de configuración almacenada en una subclave con nombre en el Registro.

Tenga en cuenta que ConfigurationHandle pasado a NdisOpenConfigurationKeyByName puede ser cualquier identificador válido para una clave del Registro ya abierta por el autor de la llamada. NdisOpenConfigurationKeyByName devuelve información de configuración para subclaves relativas a cualquier configurationHandle válido.

Después de que un controlador haya consumido y, posiblemente, modificado la información de configuración del Registro, debe llamar a la función NdisCloseConfiguration para liberar el identificador obtenido de NdisOpenConfigurationKeyByName. NdisCloseConfiguration también libera cualquier almacenamiento temporal asignado en las llamadas del controlador a NdisReadConfiguration, NdisReadNetworkAddress o NdisWriteConfiguration con las funciones SubKeyHandle que devuelve NdisOpenConfigurationKeyByName .

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con los controladores NDIS 6.0 y NDIS 5.1 (consulte NdisOpenConfigurationKeyByName (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisOpenConfigurationKeyByName (NDIS 5.1)) en Windows XP.
Plataforma de destino	Universal
Encabezado	ndis.h (incluya Ndis.h)
Library	Ndis.lib
IRQL	< DISPATCH_LEVEL
Reglas de cumplimiento de DDI	Irql_Miscellaneous_Function(ndis)