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