Función NdisOpenConfigurationKeyByIndex (ndis.h)
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 y 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, el configurationHandle de 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 va a abrir bajo 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
Ninguno
Observaciones
NdisOpenConfigurationKeyByIndex permite que un controlador acceda a la información de configuración que su archivo de instalación almacena en una subclave del Registro.
Tenga en cuenta que el configurationHandle de 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 las 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 devuelva NDIS_STATUS_FAILURE, lo que indica que no hay más subclaves que 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 que NDIS asigne a las llamadas del controlador a la NdisReadConfiguration, NdisReadNetworkAddresfunciones de NdisWriteConfiguration con el SubKeyHandle que NdisOpenConfigurationKeyByIndex devuelto.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | 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. |
| de la plataforma de destino de | Universal |
| encabezado de | ndis.h (incluya Ndis.h) |
| biblioteca de | Ndis.lib |
| irQL | < DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | Irql_Miscellaneous_Function(ndis) |