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 inizializzato 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 indica la sottochiave da aprire nella chiave già aperta con ConfigurationHandle .
[out] KeyName
Puntatore a un tipo di 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 di 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 di 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 nel file di installazione in una sottochiave del Registro di sistema.
Si noti che 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, in modo da indicare 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 per le chiamate del driver alle funzioni NdisReadConfiguration, NdisReadNetworkAddress o NdisWriteConfiguration con SubKeyHandle restituito da NdisOpenConfigurationKeyByIndex .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisOpenConfigurationKeyByIndex (NDIS 5.1)) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisOpenConfigurationKeyByIndex (NDIS 5.1)) in Windows XP. |
| Piattaforma di destinazione | Universale |
| Intestazione | ndis.h (include Ndis.h) |
| Libreria | Ndis.lib |
| IRQL | < DISPATCH_LEVEL |
| Regole di conformità DDI | Irql_Miscellaneous_Function(ndis) |