Funzione NdisOpenConfigurationKeyByName (ndis.h)
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) |