Функция NdisOpenConfigurationKeyByName (ndis.h)

Статья
08/07/2023

Функция 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 и более поздних версий эта строка содержит символы Юникода. То есть для Windows 2000 и более поздних версий NDIS определяет тип NDIS_STRING как тип UNICODE_STRING .

[out] SubKeyHandle

Указатель на переменную, предоставленную вызывающей стороны, в которой эта функция возвращает дескриптор открытого подраздела в случае успешного вызова.

Возвращаемое значение

None

Remarks

NdisOpenConfigurationKeyByName позволяет драйверу получить доступ к сведениям о конфигурации, которые хранятся в именованном подразделе в реестре.

Обратите внимание, что ConfigurationHandle , передаваемый в NdisOpenConfigurationKeyByName , может быть любым допустимым дескриптором для раздела реестра, уже открытого вызывающим элементом. NdisOpenConfigurationKeyByName возвращает сведения о конфигурации для подразделов, относящихся к любому допустимому configurationHandle .

После использования и, возможно, изменения сведений о конфигурации реестра драйвер должен вызвать функцию NdisCloseConfiguration , чтобы освободить дескриптор, полученный из NdisOpenConfigurationKeyByName. NdisCloseConfiguration также освобождает любое временное хранилище, выделенное NDIS в вызовах драйвера к функциям NdisReadConfiguration, NdisReadNetworkAddress или NdisWriteConfiguration с subKeyHandle , возвращенным NdisOpenConfigurationKeyByName .

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. раздел NdisOpenConfigurationKeyByName (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. раздел NdisOpenConfigurationKeyByName (NDIS 5.1)) в Windows XP.
Целевая платформа	Универсальное
Верхняя часть	ndis.h (включая Ndis.h)
Библиотека	Ndis.lib
IRQL	< DISPATCH_LEVEL
Правила соответствия DDI	Irql_Miscellaneous_Function(ndis)