NdisOpenConfigurationKeyByIndex 함수(ndis.h)

아티클
08/07/2023

NdisOpenConfigurationKeyByIndex 함수는 호출자가 제공한 핸들로 지정된 지정된 열린 레지스트리 키의 하위 키를 엽니다.

구문

void NdisOpenConfigurationKeyByIndex(
  [out] PNDIS_STATUS Status,
  [in]  NDIS_HANDLE  ConfigurationHandle,
  [in]  ULONG        Index,
  [out] PNDIS_STRING KeyName,
  [out] PNDIS_HANDLE KeyHandle
);

매개 변수

[out] Status

이 함수가 지정된 레지스트리 키를 열려는 시도의 상태 반환하는 호출자 제공 변수에 대한 포인터입니다. 가능한 반환 값은 다음 중 하나입니다.

NDIS_STATUS_SUCCESS

NDIS는 KeyName 및 Index 로 지정된 하위 키에 대한 액세스를 초기화했습니다.

NDIS_STATUS_FAILURE

키를 열 수 없습니다.

[in] ConfigurationHandle

하위 키를 열 레지스트리 키에 대한 핸들입니다. 일반적으로 ConfigurationHandle 은 에서 반환됩니다. NdisOpenConfigurationEx 함수입니다.

[in] Index

열 하위 키의 인덱스입니다. 이 0부터 시작하는 값은 ConfigurationHandle 로 이미 열린 키 아래에 열 하위 키를 지정합니다.

[out] KeyName

이 함수가 시스템 기본 문자 집합에서 계산된 문자열을 반환하는 호출자 제공 버퍼를 포함하는 NDIS_STRING 형식에 대한 포인터입니다. 이 문자열은 호출이 성공하는 경우 열린 하위 키의 이름을 지정합니다. Microsoft Windows 2000 이상 드라이버의 경우 이 문자열에는 유니코드 문자가 포함됩니다. 즉, Windows 2000 이상에서 NDIS는 NDIS_STRING 형식을 UNICODE_STRING 형식으로 정의합니다.

[out] KeyHandle

호출이 성공하면 이 함수가 열린 하위 키에 대한 핸들을 반환하는 호출자 제공 변수에 대한 포인터입니다.

반환 값

없음

설명

NdisOpenConfigurationKeyByIndex 를 사용하면 드라이버가 해당 설치 파일이 레지스트리 하위 키에 저장된 구성 정보에 액세스할 수 있습니다.

NdisOpenConfigurationKeyByIndex에 전달된 ConfigurationHandle은 호출자가 이미 연 레지스트리 키에 대한 유효한 핸들일 수 있습니다. NdisOpenConfigurationKeyByIndex 는 유효한 하위 키에 대한 구성 정보를 반환합니다.
ConfigurationHandle .

NdisOpenConfigurationKeyByIndex는 인덱스를 통해 하위 키를 참조하므로 드라이버는 하위 키 이름을 지정할 필요가 없습니다. 드라이버는 함수가 NDIS_STATUS_FAILURE 반환될 때까지 인덱스를 증분한 후 NdisOpenConfigurationKeyIndex 를 반복적으로 호출하여 레지스트리 하위 키 집합을 시퀀싱할 수 있으므로 열 하위 키가 더 이상 없음을 나타냅니다.

드라이버가 레지스트리에 저장된 구성 정보를 사용하고 수정한 후에는 NdisCloseConfiguration 함수를 호출하여 NdisOpenConfigurationKeyByIndex에서 가져온 핸들을 해제해야 합니다. 또한 NdisCloseConfiguration은 NdisOpenConfigurationKeyByIndex가 반환한 SubKeyHandle을 사용하여 NdisReadConfiguration, NdisReadNetworkAddress 또는 NdisWriteConfiguration 함수에 대한 드라이버 호출에 대해 NDIS가 할당한 임시 스토리지를 해제합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista에서 NDIS 6.0 및 NDIS 5.1 드라이버(NdisOpenConfigurationKeyByIndex(NDIS 5.1) 참조)에 대해 지원됩니다. Windows XP에서 NDIS 5.1 드라이버(NdisOpenConfigurationKeyByIndex(NDIS 5.1) 참조)에 대해 지원됩니다.
대상 플랫폼	유니버설
헤더	ndis.h(Ndis.h 포함)
라이브러리	Ndis.lib
IRQL	< DISPATCH_LEVEL
DDI 규정 준수 규칙	Irql_Miscellaneous_Function(ndis)