NdisOpenConfigurationKeyByIndex, fonction (ndis.h)

Article
02/29/2024

La fonction NdisOpenConfigurationKeyByIndex ouvre une sous-clé d’une clé de Registre ouverte donnée qui est désignée par un handle fourni par l’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 le status de sa tentative d’ouverture de la clé de Registre désignée. Les valeurs de retour possibles sont les 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 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] 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 de 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 du 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 comme un 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

None

Remarques

NdisOpenConfigurationKeyByIndex permet à un pilote d’accéder aux informations de configuration de son fichier d’installation stockés dans une sous-clé de Registre.

Notez que la ConfigurationHandle passée à NdisOpenConfigurationKeyByIndex peut être n’importe quel handle valide pour une clé de Registre déjà ouverte par l’appelant. NdisOpenConfigurationKeyByIndex retourne des informations de configuration pour les sous-clés par rapport à toutes les clés valides
ConfigurationHandle .

Étant donné que NdisOpenConfigurationKeyByIndex référence une sous-clé par le biais d’un index, le pilote n’a pas à spécifier de noms de sous-clés. Un pilote peut séquencer un ensemble de sous-clés de Registre en appelant à plusieurs reprises NdisOpenConfigurationKeyIndex après incrémenter l’index jusqu’à ce que la fonction retourne NDIS_STATUS_FAILURE, indiquant ainsi 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 fonctions NdisReadConfiguration, NdisReadNetworkAddress ou NdisWriteConfiguration avec le SubKeyHandle retourné par NdisOpenConfigurationKeyByIndex .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Pris en charge pour les pilotes NDIS 6.0 et NDIS 5.1 (voir NdisOpenConfigurationKeyByIndex (NDIS 5.1)) dans Windows Vista. Pris en charge pour les pilotes NDIS 5.1 (consultez NdisOpenConfigurationKeyByIndex (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)