NdisOpenConfigurationKeyByName
VOID
NdisOpenConfigurationKeyByName(
OUT PNDIS_STATUS Status,
IN NDIS_HANDLE ConfigurationHandle,
IN PNDIS_STRING SubKeyName,
OUT PNDIS_HANDLE SubKeyHandle
);
|
NdisOpenConfigurationKeyByName 함수는 호출자 제공 핸들에 의해서 지시되는 열린 레지스트리 키의 명명된 서브키를 연다.
매개변수
- Status
- 레지스트리 키를 열기위한 시도의 상태를 리턴하는 이 함수의 호출자 제공 변수를 가리킨다. 가능한 리턴값은 다음중 하나이다:
- NDIS_STATUS_SUCCESS
- NDIS가 SubKeyName에 의해서 서술된 서브키로의 접근을 초기화했다.
- NDIS_STATUS_FAILURE
- 키가 열리지 않았다.
- ConfigurationHandle
- 서브키를 열기 위한 레지스트리 키의 핸들이다. 보통 ConfigurationHandle은 NdisOpenConfiguration이나NidsOpenProtocolConfiguration 함수에 의해서 리턴된다.
- SubKeyName
- 열린 레지스트리 서브키의 이름을 서술하는 시스템 기본 문자집합 안에 호출자 제공, 카운트된 문자열을 가리킨다. 윈도우즈 2000 드라이버에서 이 문자열은 유니코드 문자들을 포함한다.
- SubKeyHandle
- 이 호출이 성공한다면 열린 서브키의 핸들을 리턴하는 이 함수의 호출자 제공 변수를 가리킨다.
주석
NdisOpenConfigurationKeyByName 함수는 드라이버로 하여금 레지스트리에 명명된 서브키에 저장된 구성정보로의 접근을 허락한다.
NdisOpenConfigurationKeyByName 함수로 전달된 the ConfigurationHandle이 호출자에 의해서 이미 열린 레지스트리 키에 대해서 유효한 핸들이 될 수 있음을 기억해라. NdisOpenConfigurationKeyByName 함수는 어떤 유효한 ConfigurationHandle과 연관된 구성 정보를 리턴한다.
드라이버가 레지스트리 구성 정보를 소비하고 변경한 후에 드라이버는 NdisOpenConfigurationKeyByName 함수로부터 얻은 핸들을 해제하기 위해서 NdisCloseConfiguration 함수를 호출해야한다. 또한 NdisCloseConfiguration 함수는 NdisReadConfiguration, NdisReadNetworkAddress, 그리고 NdisOpenConfigurationKeyByName 함수에 의해서 리턴된 SubKeyHandle을 가진 NdisWriteConfiguration 함수로의 호출에서 NDIS가 할당한 임시 저장소를 해제해야한다.
NdisOpenConfigurationKeyByName 함수의 호출자는 IRQL < DISPATCH_LEVEL에서 실행한다.
|