DoPostUpgradeProcessing

LONG __stdcall DoPostUpgradeProcessing( IN HWND hParentWindow, IN HKEY hkeyParams, IN PCWSTR szPreNT5Instance, IN PCWSTR szNT5InfId, IN HINF hinfAnswerFile, IN PCWSTR szSectionName, OUT VENDORINFO* pviVendorInfo, IN LPVOID pvReserved );

만약 네트워크 migration DLL이 마이크로 소프트 이천 업그레이드의 GUI-mode phase동안 호출된다면, DoPreUpgradeProcessing 함수를 제공해야 한다. DoPostUpgrageProcessing 함수는 AnswerFile로부터 네트워크 컴포넌트의 pre-upgrade 매개변수 값들을 읽을 수 있고 사용자가 매개변수 값들을 지정하는 것을 허락하는 사용자 인터페이스를 제공할 수 있고 윈도우즈 이천 레지스트리에 네트워크 컴포넌트의 pre-upgrade 매개변수 값들을 쓴다.

매개변수

hParentWindow

네트워크 migration DLL이 표시하는 어떤 사용자 인터페이스를 위해 부모 윈도우을 지정한다. 만약 hParentWindow가 NULL이면, NetSetup이 unattended 모드에서 실행하고 DLL이 사용자 인터페이스를 표시하기 위해 허락하지 않는다.

hKeyParams

업그레이드되는 네트워크 컴포넌트의 매개변수들을 포함하는 레지스트리 키에 대한 핸들을 지정한다. 예를 들어, 만약 TCP/IP가 업그레이드되는 컴포넌트이면, 이러한 함수는 HKEY_LOCAL_MACHINE\SYSTEM|CurrentControlSet\Service\Tcpip에 대한 핸들을 리턴한다.

szPreNT5Instance

네트워크 어댑터가 아닌 컴포넌트를 위해, szPreNT5Instance는 컴포넌트의 서비스(장치 드라이버) 이름과 같다. 네트워크 어댑터에 대해, szPreNT5Instance는 인스턴스 수가 뒤에 붙는 어댑터 서비스 이름이다. 인스턴스 수들은 시스템에서 같은 어댑터의 다중 인스턴스들과 차이가 있다.(differentiate) 예를 들어, adapter의 값은 어댑터 드라이버의 서비스 이름(어댑터)과 어댑터의 인스턴스(1)를 지정한다.

szNT5InfId

업그레이드되는 네트워크 컴포넌트의 윈도우즈 이천 hw-id(또한 장치, 하드웨어 혹은 컴포넌트 ID로 알려진)를 지정한다. 윈도우즈 이천 네트워크 INF 파일내 hw-id는 컴포넌트의 INF 파일의 Models 섹션내에 지정된다.

hintAnswerFile

열린 AnswerFile에 대한 핸들.

szSectionName

업그레이드되는 컴포넌트의 매개변수들을 포함하는 AnswerFile내 섹션의 이름.

AnswerFile내 네트워크 컴포넌트의 OEM 섹션의 이름을 지정한다. 이 섹션은 업그레이드되는 네트워크 컴포넌트의 pre-upgrade 매개변수 값들을 포함한다. szSectionName 매개변수는 다음과 같은 포맷을 가진다. :

params.Windows-2000-InfID.OemSection

이것은 Windows-2000-InfID가 업그레이드되는 네트워크 컴포넌트의 윈도우즈 이천 hw-id이다.

pviVendorInfo

다음과 같이 정의되는 VENDORINFO 구조체로서 포맷된 벤더 특정 정보를 지정한다.


   typedef struct 

   {

      WCHAR szCompanyName[256];

      WCHAR szSupportNumber[256];

      WCHAR szSupportUrl[256];

      WCHAR szInstructionToUser[1024];

   } VENDORINFO;

이 구조체의 멤버들은 다음과 같은 데이터를 포함한다:

szCompanyName: 벤더의 이름을 지정한다.
szSupportNumber: 기술 지원의 전화 번호를 지정한다.
szSupportUrl: 기술 지원을 제공하는 웹 사이트 URL를 지정한다.
szInstructionsToUser: 네트워크 migration DLL에 속한 추가적인 명령어들을 지정한다.

pvReserved

예약

리턴값

ERROR_SUCCESS: DoPostUpgradeProcessing 함수가 성공했다.
ERROR_XXX: 실패의 이유를 지정하는 마이크로소프트 Win32 에러 코드. 그러한 에러 코드를 리턴하는 것은 NetSetup이 에러 메시지를 표시하게 하고 네트워크 migration DLL 파일들을 지우고 사용자에게 윈도우즈 이천 업그레이드를 종료하도록 prompt한다.

주석

만약 네트워크 migration DLL의 DoPreUpgradeProcessing 함수가 NUA_LOAD_POST_UPGRADE 플래그를 설정한다면, NetSetup은 업그레이드된 운영체제에서 실행하는 upgrade 프로세스의 GUI 모드 부분동안 migration DLL을 호출한다. GUI 모드동안, migration DLL은 업그레이드된 각 네트워크 컴포넌트를 위해 사용자 특정 매개변수 값들을 입력하고 AnswerFile(Winnt.sif)로부터 pre-upgrade 매개변수 값들을 읽고 레지스트리내 컴포넌트의 Parameters 키에 대한 매개변수 값들을 쓴다. NetSetup은 윈도우즈 이천 네트워크 컴포넌트들을 migrate하기 위해 윈도우즈 이천 업그레이드하는 동안 AnswerFile을 사용한다.

만약 네트워크 migration DLL이 GUI 모드동안 Netsetup에 의해 호출된다면, DoPostUpgradeProcessing함수와 또한 PostUpgradeInitialize 함수를 익스포트해야 한다. NetSetup이 PostUpgradeInitialize 함수를 호출한 후, 업그레이드되는 각 네트워크 컴포넌트를 위해 한번 DoPostUpgradeProcessing 함수를 호출한다.

DoPostUpgradeProcessing 함수로 NetSetup에 의해 제공된 szPreNT5Instance와 szNT5InfId는 업그레이드되는 컴포넌트를 지정한다.(identify) 만약 migration DLL이 unattended 모드에서 실행하지 않는다면, hParentWindow에 의해 지정된 부모 윈도우 아래서 사용자 인터페이스를 지정한다.

DoPostUpgradeProcessing 함수는 업그레이드되는 컴포넌트를 위한 pre-upgrade 매개변수 값들을 얻기 위해 szSectionName에 의해 지정된 AnswerFile 섹션을 읽는다. DoPostUpgradeProcessing 함수는 AnswerFile에 접근하기 위해 hinfAnswerFile에 제공된 AnswerFile 에 대한 핸들을 사용한다. DoPostUpgradeProcessing 함수는 AnswerFile에 접근하기 위해 SetupXxx 함수들을 사용한다. SetupXxx 함수들에 대한 더 자세한 정보에 대해, Platform SDK 문서를 봐라.

AnswerFile의 특정 섹션으로부터, DoPostUpgradeProcessing 함수는 migration DLL의 DoPreUpgradeProcessing 함수가 업그레이드 프로세스의 Winnt32 phase 동안 쓰는 컴포넌트 특정 매개변수 값들을 읽는다. DoPreUpgradeProcessing 함수는 특정 AnswerFile 섹션으로부터 매개변수 값들을 읽기 위해 적당한 SetupGetXxx 함수를 호출한다.

DoPostUpgradeProcessing 함수는 hKeyParams에 의해 지정된 업그레이드된 컴포넌트의 Parameters 레지스트리 키에 대한 사용자에 의해 제공된 어떤 매개변수 값들과 마찬가지로 AnswerFile로부터 얻는 매개변수들을 쓴다.

DoPostUpgradeProcessing 함수는 VENDORINFO 구조체로서 포맷된 벤더 정보를 가리키는 NetSetup에 포인터(pviVendorInfo)를 전달한다. NetSetup은 만약 DoPostUpgradeProcessing 함수가 Win32 에러 코드를 리턴하면 이러한 정보를 표시한다.