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 还会释放驱动程序调用 NdisReadConfigurationNDIS 分配的任何临时存储，NdisReadNetworkAdd或 NdisWriteConfiguration 函数，NdisOpenConfigurationKeyByName 返回的 SubKeyHandle。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows Vista 中支持 NDIS 6.0 和 NDIS 5.1 驱动程序（请参阅 NdisOpenConfigurationKeyByName （NDIS 5.1）。 在 Windows XP 中支持 NDIS 5.1 驱动程序（请参阅 NdisOpenConfigurationKeyByName （NDIS 5.1）。 |
| 目标平台 | 普遍 |
| 标头 | ndis.h （包括 Ndis.h） |
| 库 | Ndis.lib |
| IRQL | < DISPATCH_LEVEL |
| DDI 符合性规则 | Irql_Miscellaneous_Function（ndis） |