Función NdisOpenConfigurationKeyByIndex (ndis.h)

Artículo
08/07/2023

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

Sintaxis

void NdisOpenConfigurationKeyByIndex(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  ConfigurationHandle,
  [in]  ULONG        Index,
  [out] PNDIS_STRING KeyName,
  [out] PNDIS_HANDLE KeyHandle
);

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 designada. Los valores devueltos posibles son uno de los siguientes:

NDIS_STATUS_SUCCESS

NDIS ha inicializado el acceso a la subclave especificada por KeyName e Index .

NDIS_STATUS_FAILURE

No se pudo abrir la clave.

[in] ConfigurationHandle

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

[in] Index

Índice de la subclave que se va a abrir. Este valor de base cero designa la subclave que se abrirá en la clave ya abierta con ConfigurationHandle .

[out] KeyName

Puntero a un tipo de NDIS_STRING que contiene un búfer proporcionado por el autor de la llamada en el que esta función devuelve una cadena contada en el juego de caracteres predeterminado del sistema. Esta cadena especifica el nombre de la subclave abierta si la llamada se realiza correctamente. 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 de NDIS_STRING como un tipo de UNICODE_STRING .

[out] KeyHandle

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 la llamada se realiza correctamente.

Valor devuelto

None

Observaciones

NdisOpenConfigurationKeyByIndex permite que un controlador acceda a la información de configuración que su archivo de instalación almacenado en una subclave del Registro.

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

Dado que NdisOpenConfigurationKeyByIndex hace referencia a una subclave a través de un índice, el controlador no tiene que especificar nombres de subclave. Un controlador puede secuenciar a través de un conjunto de subclaves del Registro llamando repetidamente a NdisOpenConfigurationKeyIndex después de incrementar el índice hasta que la función devuelve NDIS_STATUS_FAILURE, lo que indica que no hay más subclaves para abrir.

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

Requisitos

Requisito	Value
Cliente mínimo compatible	Compatible con controladores NDIS 6.0 y NDIS 5.1 (consulte NdisOpenConfigurationKeyByIndex (NDIS 5.1)) en Windows Vista. Compatible con los controladores NDIS 5.1 (consulte NdisOpenConfigurationKeyByIndex (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)