NdisOpenConfigurationKeyByName, fonction (ndis.h)
La fonction NdisOpenConfigurationKeyByName ouvre une sous-clé nommée d’une clé de Registre ouverte donnée qui est désignée par un handle fourni par l’appelant.
Syntaxe
void NdisOpenConfigurationKeyByName(
[out] PNDIS_STATUS Status,
[in] NDIS_HANDLE ConfigurationHandle,
[in] PNDIS_STRING SubKeyName,
[out] PNDIS_HANDLE SubKeyHandle
);
Paramètres
[out] Status
Pointeur vers une variable fournie par l’appelant dans laquelle cette fonction retourne le status de sa tentative d’ouverture de la clé de Registre. Les valeurs de retour possibles sont l’une des suivantes :
NDIS_STATUS_SUCCESS
NDIS a initialisé l’accès à la sous-clé spécifiée par SubKeyName .
NDIS_STATUS_FAILURE
Impossible d’ouvrir la clé.
[in] ConfigurationHandle
Handle d’une clé de Registre pour laquelle une sous-clé doit être ouverte. En règle générale, ConfigurationHandle est retourné par le Fonction NdisOpenConfigurationEx .
[in] SubKeyName
Pointeur vers un type NDIS_STRING contenant une chaîne fournie par l’appelant dans le jeu de caractères par défaut du système qui spécifie le nom de la sous-clé de Registre à ouvrir. Pour les pilotes Microsoft Windows 2000 et versions ultérieures, cette chaîne contient des caractères Unicode. Autrement dit, pour Windows 2000 et versions ultérieures, NDIS définit le type NDIS_STRING comme un type UNICODE_STRING .
[out] SubKeyHandle
Pointeur vers une variable fournie par l’appelant dans laquelle cette fonction retourne un handle à la sous-clé ouverte si cet appel réussit.
Valeur de retour
None
Remarques
NdisOpenConfigurationKeyByName permet à un pilote d’accéder aux informations de configuration stockées dans une sous-clé nommée dans le Registre.
Notez que la ConfigurationHandle passée à NdisOpenConfigurationKeyByName peut être n’importe quel handle valide pour une clé de Registre déjà ouverte par l’appelant. NdisOpenConfigurationKeyByName retourne des informations de configuration pour les sous-clés relatives à toute ConfigurationHandle valide.
Une fois qu’un pilote a consommé et, éventuellement, modifié les informations de configuration du Registre, il doit appeler la fonction NdisCloseConfiguration pour libérer le handle obtenu à partir de NdisOpenConfigurationKeyByName. NdisCloseConfiguration libère également tout stockage temporaire alloué par NDIS dans les appels du pilote aux fonctions NdisReadConfiguration, NdisReadNetworkAddress ou NdisWriteConfiguration avec le SubKeyHandle retourné par NdisOpenConfigurationKeyByName .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisOpenConfigurationKeyByName (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (voir NdisOpenConfigurationKeyByName (NDIS 5.1)) dans Windows XP. |
| Plateforme cible | Universal |
| En-tête | ndis.h (inclure Ndis.h) |
| Bibliothèque | Ndis.lib |
| IRQL | < DISPATCH_LEVEL |
| Règles de conformité DDI | Irql_Miscellaneous_Function(ndis) |