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 允许驱动程序访问存储在注册表中命名子项中的配置信息。

请注意,传入到 NdisOpenConfigurationKeyByNameConfigurationHandle 可以是调用方已打开的注册表项的任何有效句柄。 NdisOpenConfigurationKeyByName 返回相对于任何有效 ConfigurationHandle 的子项的配置信息。

驱动程序使用并可能修改注册表配置信息后,必须调用 NdisCloseConfiguration 函数以释放从 NdisOpenConfigurationKeyByName 获取的句柄。 NdisCloseConfiguration 还会释放 NDIS 在驱动程序调用 NdisReadConfigurationNdisReadNetworkAddressNdisWriteConfiguration 函数以及 NdisOpenConfigurationKeyByName 返回的 SubKeyHandle 时分配的任何临时存储。

要求

要求
最低受支持的客户端 NDIS 6.0 和 NDIS 5.1 驱动程序支持 (请参阅 Windows Vista 中的 NdisOpenConfigurationKeyByName (NDIS 5.1) ) 。 NDIS 5.1 驱动程序支持 (请参阅 Windows XP 中的 NdisOpenConfigurationKeyByName (NDIS 5.1) ) 。
目标平台 通用
标头 ndis.h (包括 Ndis.h)
Library Ndis.lib
IRQL < DISPATCH_LEVEL
DDI 符合性规则 Irql_Miscellaneous_Function (ndis)

另请参阅

ANSI_STRING

MiniportInitializeEx

NdisCloseConfiguration

NdisOpenConfigurationEx

NdisOpenConfigurationKeyByIndex

NdisReadConfiguration

NdisWriteConfiguration

ProtocolBindAdapterEx

UNICODE_STRING