Funzione NdisOpenConfigurationKeyByIndex (ndis.h)
La funzione NdisOpenConfigurationKeyByIndex apre una sottochiave di una determinata chiave del Registro di sistema aperta designata da un handle fornito dal chiamante.
Sintassi
void NdisOpenConfigurationKeyByIndex(
[out] PNDIS_STATUS Status,
[in] NDIS_HANDLE ConfigurationHandle,
[in] ULONG Index,
[out] PNDIS_STRING KeyName,
[out] PNDIS_HANDLE KeyHandle
);
Parametri
[out] Status
Puntatore a una variabile fornita dal chiamante in cui questa funzione restituisce lo stato del tentativo di aprire la chiave del Registro di sistema designata. I valori restituiti possibili sono uno dei seguenti:
NDIS_STATUS_SUCCESS
NDIS ha eseguito l'accesso alla sottochiave specificata da KeyName e Index .
NDIS_STATUS_FAILURE
Impossibile aprire la chiave.
[in] ConfigurationHandle
Handle di una chiave del Registro di sistema per la quale deve essere aperta una sottochiave. In genere, ConfigurationHandle viene restituito da funzione NdisOpenConfigurationEx.
[in] Index
Indice della sottochiave da aprire. Questo valore in base zero definisce la sottochiave da aprire sotto la chiave già aperta con ConfigurationHandle .
[out] KeyName
Puntatore a un tipo NDIS_STRING contenente un buffer fornito dal chiamante in cui questa funzione restituisce una stringa con conteggiata nel set di caratteri predefinito del sistema. Questa stringa specifica il nome della sottochiave aperta se la chiamata ha esito positivo. Per i driver Microsoft Windows 2000 e versioni successive, questa stringa contiene caratteri Unicode. Ovvero, per Windows 2000 e versioni successive, NDIS definisce il tipo di NDIS_STRING come tipo UNICODE_STRING.
[out] KeyHandle
Puntatore a una variabile fornita dal chiamante in cui questa funzione restituisce un handle alla sottochiave aperta se la chiamata ha esito positivo.
Valore restituito
Nessuno
Osservazioni
NdisOpenConfigurationKeyByIndex consente a un driver di accedere alle informazioni di configurazione archiviate in una sottochiave del Registro di sistema.
Si noti che il ConfigurationHandle passato a NdisOpenConfigurationKeyByIndex può essere qualsiasi handle valido per una chiave del Registro di sistema già aperta dal chiamante.
NdisOpenConfigurationKeyByIndex restituisce informazioni di configurazione per le sottochiavi relative a qualsiasi valore valido
ConfigurationHandle .
Poiché NdisOpenConfigurationKeyByIndex fa riferimento a una sottochiave tramite un indice, il driver non deve specificare nomi di sottochiave. Un driver può eseguire una sequenza tramite un set di sottochiavi del Registro di sistema chiamando ripetutamente NdisOpenConfigurationKeyIndex dopo aver incrementato l'indice fino a quando la funzione non restituisce NDIS_STATUS_FAILURE, indicando quindi che non sono presenti più sottochiavi da aprire.
Dopo che un driver ha utilizzato e, possibilmente, modificato le informazioni di configurazione archiviate nel Registro di sistema, deve chiamare la funzione NdisCloseConfiguration per rilasciare l'handle ottenuto da NdisOpenConfigurationKeyByIndex. NdisCloseConfiguration libera anche qualsiasi risorsa di archiviazione temporanea allocata da NDIS per le chiamate del driver al NdisReadConfiguration, NdisReadNetworkAddresso funzioni di NdisWriteConfiguration con il SubKeyHandle restituito NdisOpenConfigurationKeyByIn dex.