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型別的指標，其中包含所提供之呼叫端提供的計數位符串系統預設字元集中，指定要開啟之登錄子機碼的名稱。 對於 Microsoft Windows 2000 和更新版本的驅動程式，此字串包含 Unicode 字元。 也就是說，對於 Windows 2000 和更新版本，NDIS 會將NDIS_STRING類型定義為 UNICODE_STRING 類型。
[out] SubKeyHandle
呼叫端提供之變數的指標，如果此呼叫成功，此函式會傳回開啟之子機碼的句柄。
傳回值
無
備註
NdisOpenConfigurationKeyByName 可讓驅動程式存取儲存在登錄中具名子機碼中的組態資訊。
請注意，傳入至 NdisOpenConfigurationKeyByName 的 ConfigurationHandle 可以是呼叫端已開啟之登錄機碼的任何有效句柄。 NdisOpenConfigurationKeyByName 會傳回子機碼的組態資訊，相對於任何有效的 ConfigurationHandle 。
在驅動程式取用且可能修改登錄組態信息之後，它必須呼叫 NdisCloseConfiguration 函式來釋放從 NdisOpenConfigurationKeyByName 取得的句柄。 NdisCloseConfiguration 也會釋放驅動程式呼叫 NdisReadConfiguration、 NdisReadNetworkAddress 或 NdisWriteConfiguration 函式時所傳回 的 SubKeyHandle中 配置的任何暫存記憶體。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | (支援 NDIS 6.0 和 NDIS 5.1 驅動程式，請參閱 Windows Vista 中的 NdisOpenConfigurationKeyByName (NDIS 5.1) ) 。 支援 NDIS 5.1 驅動程式 (請參閱 Windows XP 中的 NdisOpenConfigurationKeyByName (NDIS 5.1) ) 。 |
| 目標平台 | Universal |
| 標頭 | ndis.h (包含 Ndis.h) |
| 程式庫 | Ndis.lib |
| IRQL | < DISPATCH_LEVEL |
| DDI 合規性規則 | Irql_Miscellaneous_Function (ndis) |