Funzione NdisOpenConfigurationKeyByIndex (ndis.h)

Articolo
08/07/2023

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)