NdisOpenConfigurationKeyByName 函式 （ndis.h）
NdisOpenConfigurationKeyByName 函式會開啟指定開啟登錄機碼的具名子機碼，並由呼叫端提供的句柄指定。
語法
void NdisOpenConfigurationKeyByName(
[out] PNDIS_STATUS Status,
[in] NDIS_HANDLE ConfigurationHandle,
[in] PNDIS_STRING SubKeyName,
[out] PNDIS_HANDLE SubKeyHandle
);
參數
[out] Status
呼叫端提供的變數指標，在此變數中，此函式會傳回其嘗試開啟登錄機碼的狀態。 可能的傳回值為下列其中一項：
NDIS_STATUS_SUCCESS
NDIS 已初始化為 SubKeyName 所指定的子機碼。
NDIS_STATUS_FAILURE
無法開啟金鑰。
[in] ConfigurationHandle
應該開啟子機碼之登錄機碼的句柄。 一般而言，ConfigurationHandle 是由 傳回 NdisOpenConfigurationEx 函式。
[in] SubKeyName
NDIS_STRING型別的指標，其中包含要開啟之登錄子機碼名稱的系統預設字元集中提供的計數位符串。 對於 windows 2000 和更新版本的驅動程式Microsoft，此字串包含 Unicode 字元。 也就是說，針對 Windows 2000 和更新版本，NDIS 會將NDIS_STRING類型定義為 UNICODE_STRING 類型。
[out] SubKeyHandle
呼叫端提供的變數指標，如果這個呼叫成功，此函式會傳回開啟子機碼的句柄。
傳回值
沒有
言論
NdisOpenConfigurationKeyByName 可讓驅動程式存取儲存在登錄中具名子機碼中的組態資訊。
請注意，傳入至 NdisOpenConfigurationKeyByName 的 ConfigurationHandle 可以是呼叫者已開啟之登錄機碼的任何有效句柄。 NdisOpenConfigurationKeyByName 傳回子機碼的組態資訊，相對於任何有效的 ConfigurationHandle 。
在驅動程式取用和可能修改登錄組態信息之後，它必須呼叫 NdisCloseConfiguration 函式，以釋放從 NdisOpenConfigurationKeyByName取得的句柄。 NdisCloseConfiguration 也會釋放驅動程式呼叫 NdisReadConfiguration中配置 NDIS 的任何暫存記憶體，NdisReadNetworkAddress或 NdisWriteConfiguration 函式，SubKeyHandle 傳回 NdisOpenConfigurationKeyByName。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 支援 Windows Vista 中的 NDIS 6.0 和 NDIS 5.1 驅動程式（請參閱 NdisOpenConfigurationKeyByName （NDIS 5.1） 。 支援 NDIS 5.1 驅動程式（請參閱 Windows XP 中的 NdisOpenConfigurationKeyByName （NDIS 5.1）。 |
| 目標平臺 | 普遍 |
| 標頭 | ndis.h （包括 Ndis.h） |
| 連結庫 | Ndis.lib |
| IRQL | < DISPATCH_LEVEL |
| DDI 合規性規則 | Irql_Miscellaneous_Function（ndis） |