Funzione NdisOpenConfigurationKeyByName (ndis.h)

Articolo
08/07/2023

La funzione NdisOpenConfigurationKeyByName apre una sottochiave denominata di una determinata chiave del Registro di sistema aperta designata da un handle fornito dal chiamante.

Sintassi

void NdisOpenConfigurationKeyByName(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  ConfigurationHandle,
  [in]  PNDIS_STRING SubKeyName,
  [out] PNDIS_HANDLE SubKeyHandle
);

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. I valori restituiti possibili sono uno dei seguenti:

NDIS_STATUS_SUCCESS

NDIS ha inizializzato l'accesso alla sottochiave specificata da SubKeyName .

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] SubKeyName

Puntatore a un tipo di NDIS_STRING contenente una stringa fornita dal chiamante, contato nel set di caratteri predefinito del sistema che specifica il nome della sottochiave del Registro di sistema da aprire. 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] SubKeyHandle

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

NdisOpenConfigurationKeyByName consente a un driver di accedere alle informazioni di configurazione archiviate in una sottochiave denominata nel Registro di sistema.

Si noti che ConfigurationHandle passato a NdisOpenConfigurationKeyByName può essere qualsiasi handle valido per una chiave del Registro di sistema già aperta dal chiamante. NdisOpenConfigurationKeyByName restituisce informazioni di configurazione per le sottochiavi relative a qualsiasi configurationHandle valido.

Dopo che un driver ha utilizzato e, possibilmente, modificato le informazioni di configurazione del Registro di sistema, deve chiamare la funzione NdisCloseConfiguration per rilasciare l'handle ottenuto da NdisOpenConfigurationKeyByName. NdisCloseConfiguration libera anche qualsiasi risorsa di archiviazione temporanea allocata dai NDIS nelle chiamate del driver alle funzioni NdisReadConfiguration, NdisReadNetworkAddress o NdisWriteConfiguration con subKeyHandle restituito da NdisOpenConfigurationKeyByName .

Requisiti

Requisito	Valore
Client minimo supportato	Supportato per i driver NDIS 6.0 e NDIS 5.1 (vedere NdisOpenConfigurationKeyByName (NDIS 5.1)) in Windows Vista. Supportato per i driver NDIS 5.1 (vedere NdisOpenConfigurationKeyByName (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)