NdisOpenConfigurationKeyByIndex, fonction (ndis.h)
La fonction NdisOpenConfigurationKeyByIndex ouvre une sous-clé d’une clé de Registre ouverte donnée désignée par un handle fourni par un appelant.
Syntaxe
void NdisOpenConfigurationKeyByIndex(
[out] PNDIS_STATUS Status,
[in] NDIS_HANDLE ConfigurationHandle,
[in] ULONG Index,
[out] PNDIS_STRING KeyName,
[out] PNDIS_HANDLE KeyHandle
);
Paramètres
[out] Status
Pointeur vers une variable fournie par l’appelant dans laquelle cette fonction retourne l’état de sa tentative d’ouverture de la clé de Registre désignée. 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 KeyName et Index .
NDIS_STATUS_FAILURE
Impossible d’ouvrir la clé.
[in] ConfigurationHandle
Handle vers 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] Index
Index de la sous-clé à ouvrir. Cette valeur de base zéro désigne la sous-clé à ouvrir sous la clé déjà ouverte avec ConfigurationHandle .
[out] KeyName
Pointeur vers un type NDIS_STRING contenant une mémoire tampon fournie par l’appelant dans laquelle cette fonction retourne une chaîne comptée dans le jeu de caractères par défaut système. Cette chaîne spécifie le nom de la sous-clé ouverte si l’appel réussit. 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 en tant que type UNICODE_STRING.
[out] KeyHandle
Pointeur vers une variable fournie par l’appelant dans laquelle cette fonction retourne un handle à la sous-clé ouverte si l’appel réussit.
Valeur de retour
Aucun
Remarques
NdisOpenConfigurationKeyByIndex permet à un pilote d’accéder aux informations de configuration stockées dans une sous-clé de Registre.
Notez que le ConfigurationHandle transmis à NdisOpenConfigurationKeyByIndex peut être n’importe quel handle valide sur une clé de Registre déjà ouverte par l’appelant.
NdisOpenConfigurationKeyByIndex retourne des informations de configuration pour les sous-clés relatives à n’importe quelle valeur valide
ConfigurationHandle .
Étant donné NdisOpenConfigurationKeyByIndex fait référence à une sous-clé via un index, le pilote n’a pas à spécifier de noms de sous-clé. Un pilote peut séquencer un ensemble de sous-clés de Registre en appelant à plusieurs reprises NdisOpenConfigurationKeyIndex après l’incrémentation de l’index jusqu’à ce que la fonction retourne NDIS_STATUS_FAILURE, ce qui indique qu’il n’y a plus de sous-clés à ouvrir.
Une fois qu’un pilote a consommé et éventuellement modifié les informations de configuration stockées dans le Registre, il doit appeler la fonction NdisCloseConfiguration pour libérer le handle obtenu à partir de NdisOpenConfigurationKeyByIndex. NdisCloseConfiguration libère également tout stockage temporaire alloué par NDIS pour les appels du pilote aux NdisReadConfiguration, NdisReadNetworkAddressou fonctions NdisWriteConfiguration avec le SubKeyHandle qui NdisOpenConfigurationKeyByIndex retourné.