Función NdisOpenConfigurationKeyByName (ndis.h)
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, el configurationHandle de devuelve función NdisOpenConfigurationEx.
[in] SubKeyName
Puntero a un tipo de NDIS_STRING que contiene una cadena 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 de 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
Ninguno
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 el ConfigurationHandle pasado a NdisOpenConfigurationKeyByName puede ser cualquier identificador válido en 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 que NDIS asigne en las llamadas del controlador a la NdisReadConfiguration, NdisReadNetworkAddress, o funciones de NdisWriteConfiguration con el SubKeyHandle que NdisOpenConfigurationKeyByName devuelto.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | 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. |
| 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) |