NdisOpenConfigurationKeyByIndex

VOID NdisOpenConfigurationKeyByIndex( OUT PNDIS_STATUS Status, IN NDIS_HANDLE ConfigurationHandle, IN ULONG Index, OUT PNDIS_STRING KeyName, OUT PNDIS_HANDLE KeyHandle );

NdisOpenConfigurationKeyByIndex 함수는 호출자 제공 핸들에 의해서 명시된 열린 레지스트리 키의 서브키를 연다.

매개변수

Status

명시된 레지스트리 키를 열기 위한 시도의 상태를 리턴하는 이 함수의 호출자 제공 변수를 가리킨다. 가능한 리턴값은 다음중 하나이다:

NDIS_STATUS_SUCCESS

NDIS는 KeyName과 Index에 의해서 서술된 서브키로의 접근을 초기화했다.

NDIS_STATUS_FAILURE

키가 열리지 않았다.

ConfigurationHandle

서브키를 열기 위한 레지스트리 키의 핸들이다. 보통 ConfigurationHandle은 NdisOpenConfiguration이나NidsOpenProtocolConfiguration 함수에 의해서 리턴된다.

Index

열린 서브키의 인덱스를 서술한다. 0 기반의 이 값은 ConfigurationHandle을 가지고 이미 열린 키 중에서 열리는 서브키를 명시한다.

KeyName

호출이 성공한다면 열린 서브키의 이름을 서술하는 시스템 기본 문자집합에서 카운트된 문자열을 리턴하는 이 함수의 호출자 제공 변수를 가리킨다. 윈도우즈 2000 드라이버에서 이 문자열은 유니코드 문자들을 포함한다.

KeyHandle

호출이 성공한다면 열린 서브키에 대한 핸들을 리턴하는 호출자 제공 변수를 가리킨다.

주석

NdisOpenConfigurationKeyByIndex 함수는 드라이버로 하여금 레지스트리 서브키에 저장된 설치 스크립트의 구성 정보로의 접근을 허락한다.

NdisOpenConfigurationKeyByIndex 함수로 전달된 ConfigurationHandle이 호출자에 의해서 이미 열린 레지스트리 키에 대해서 유효한 핸들이 될 수 있음을 기억해라. NdisOpenConfigurationKeyByIndex 함수는 어떤 유효한 ConfigurationHandle과 연관된 서브키를 위해서 구성 정보를 리턴한다.

NdisOpenConfigurationKeyByIndex 함수가 인덱스를 통해서 서브키를 참조한 후에 드라이버는 서브키 이름을 서술하지 말아야한다. 드라이버는 함수가 더이상 열릴 서브키가 없음을 의미하는 NDIS_STATUS_FAILURE를 리턴할 때까지 인덱스를 증가한 후에 반복적으로 NdisOpenConfigurationKeyIndex 함수를 호출하므로써 레지스트리 서브키들의 집합을 통해서 순서화될 수 있다.

드라이버가 레지스트리에 저장된 구성정보를 소비하고 변경한 후에 드라이버는 NdisOpenConfigurationKeyByIndex 함수로부터 얻은 핸들을 해제하기 위해서 NdisCloseConfiguration 함수를 호출해야한다. 또한 NdisCloseConfiguration 함수는 NdisReadConfiguration, NdisReadNetworkAddress, 그리고 NdisOpenConfigurationKeyByIndex 함수에 의해서 리턴된 SubKeyHandle을 가진 NdisWriteConfiguration 함수로의 드라이버 호출을 위해서 NDIS가 할당한 임시 저장소를 해제해야한다.

NdisOpenConfigurationKeyByIndex 함수의 호출자는 IRQL< DISPATCH_LEVEL에서 실행한다.