Функция 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
Указатель на указанную вызывающим переменную, в которой эта функция возвращает дескриптор открытого подраздела, если этот вызов выполнен успешно.
Возвращаемое значение
Никакой
Замечания
NdisOpenConfigurationKeyByName позволяет драйверу получить доступ к сведениям о конфигурации, хранящимся в именованном подразделе в реестре.
Обратите внимание, что ConfigurationHandle, переданной в NdisOpenConfigurationKeyByName, может быть любым допустимым дескриптором раздела реестра, который уже открыл вызывающий объект. NdisOpenConfigurationKeyByName возвращает сведения о конфигурации для вложенных ключей относительно любого допустимого ConfigurationHandle.
После использования драйвера и, возможно, изменения сведений о конфигурации реестра он должен вызвать функцию NdisCloseConfiguration, чтобы освободить дескриптор, полученный из NdisOpenConfigurationKeyByName. NdisCloseConfiguration также освобождает любое временное хранилище, выделенное NDIS в вызовах драйвера к NdisReadConfiguration, NdisReadNetworkAddres функцииили NdisWriteConfiguration с возвращенным SubKeyHandleNdisOpenConfigurationKey Name.