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 을 사용하면 드라이버가 레지스트리의 명명된 하위 키에 저장된 구성 정보에 액세스할 수 있습니다.
NdisOpenConfigurationKeyByName에 전달된 ConfigurationHandle은 호출자가 이미 연 레지스트리 키에 대한 유효한 핸들일 수 있습니다. NdisOpenConfigurationKeyByName 은 유효한 ConfigurationHandle 에 상대적인 하위 키에 대한 구성 정보를 반환합니다.
드라이버가 레지스트리 구성 정보를 사용하고 수정한 후에는 NdisCloseConfiguration 함수를 호출하여 NdisOpenConfigurationKeyByName에서 가져온 핸들을 해제해야 합니다. 또한 NdisCloseConfiguration은 NdisOpenConfigurationKeyByName이 반환한 SubKeyHandle을 사용하여 NdisReadConfiguration, NdisReadNetworkAddress 또는 NdisWriteConfiguration 함수에 대한 드라이버 호출에 NDIS가 할당한 임시 스토리지를 해제합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | 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) |