DoPreUpgradeProcessing

LONG __stdcall DoPreUpgradeProcessing( IN HWND hParentWindow, IN HKEY hkeyParams, IN PCWSTR szPreNT5InfId, IN PCWSTR szNT5InfId, IN PCWSTR szSectionName, OUT VENDORINFO* pviVendorInfo, OUT DWORD* pdwFlags, IN LPVOID pvReserved );

네트워크 migration DLL은 DoPreUpgradeProcessing 함수를 제공해야 한다. DoPreUpgradeProcessing함수는 윈도우즈 이천에 네트워크 컴포넌트의 pre-upgrade 매개변수 값들의 마이그레이트하는(migratig) 것을 지원한다.

매개변수

hParentWindow

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

hKeyParams

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

szPreNT5InfId

업그레이드될 네트워크 컴포넌트를 위한 pre-Windows 2000 INF ID를 지정한다. szPreNT5InfId는 컴포넌트의 마이크로소프트 NT 3.1 혹은 윈도우즈 NT 4.0 INF 파일이다.

szPreNT5Instance

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

szNT5InfId

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

szSectionName

AnswerFile내 네트워크 컴포넌트의 OEM 섹션의 이름을 지정한다. szSectionName 매개변수는 다음과 같은 포맷을 가진다. :

params.Windows-2000-InfID.OemSection

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

네트워크 migration DLL은 이러한 섹션에 대한 컴포넌트 특정 정보를 쓴다.

pviVendorInfo

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


   typedef struct 

   {

      WCHAR szCompanyName[256];

      WCHAR szSupportNumber[256];

      WCHAR szSupportUrl[256];

      WCHAR szInstructionToUser[1024];

   } VENDORINFO;

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

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

pdwFlags

0으로 지정하거나 NetSetup이 특정 행동을 하도록 요구한다.

값 의미

zero 어떠한 행동을 하라고 NetSetup에게 요구하지 않는다.

NUA_LOAD_POST_UPGRADE NetSetup에게 GUI 모드 셋업동안 Upgrade DLL을 호출하도록 NetSetup을 요구한다.

NUA_REQUEST_ABORT_UPGRADE NetSetup에게 업그레이드를 그만두든지 계속할 것인지 사용자에게 물어보기 위해 메시지 박스를 표시하도록 요구한다.

pvReserved

예약

리턴값

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

주석

네트워크 업그레이드 프로세스의 Winnt32 phase동안 네트워크 migration DLL의 PreUpgradeInitialize 함수를 호출한 후, NetSetup은 업그레이드되는 각 네트워크 컴포넌트를 위해 한번 DoPreUpgradeProcessing 함수를 호출한다. DoPreUpgradeProcessing 함수는 윈도우즈 이천이 업그레이드되는 시스템에서 인스톨되기 전에 호출된다.

DoPreUpgradeProcessing 함수는 다음과 같은 어떤 것 혹은 모두 할 수 있다:

레지스트리로부터 네트워크 컴포넌트의 pre-upgrade 매개변수 값들을 읽는다.

만약 unattended 모드에서 실행하지 않는다면, 사용자 입력을 얻기 위해 사용자 인터페이스를 표시한다.

AnswerFile(Winnt.sif)에 대한 다른 컴포넌트 특정 정보와 함께 네트워크 컴포넌트의 pre-upgrade 매개변수들을 쓴다. NetSetup 함수는 윈도우즈 이천에 대한 네트워크 컴포넌트들을 migrate하기 위해 윈도우즈 이천 업그레이드하는 동안 AnswerFile을 사용한다.

AnswerFile내에 적당한 엔트리들을 만듦으로써 네트워크 컴포넌트와 관련된 바이너리 데이터를 Migrate한다.

DoPreUpgradeProcessing 함수는 업그레이드되는 컴포넌트를 지정하기 위해(identify) NetSetup에 의해 제공된 szPreNT5Instance와 szNT5InfId 매개변수들을 사용한다.

DoPreUpgradeProcessing 함수는 전형적으로 레지스트리로부터 그들을 읽음으로써 네트워크 컴포넌트의 pre-upgrade 매개변수 값들을 얻는다. DoPreUpgradeProcessing 함수는 NetSetup에 의해 지정된 키 hkeyParams아래서 이러한 값들을 발견한다.

만약 migration DLL은 unattended mode에서 실행되지 않는다면, 또한 hParentWindow에 의해 지정된 부모 윈도우 아래서 pre-upgrade 시스템 아래서 사용자 인터페이스를 표시할 수 있다. 비록 이러한 인터페이스를 통해, 사용자는 네트워크 migration DLL이 업그레이드된 컴포넌트를 migrate할 컴포넌트 특정 매개변수들을 지정할 수 있다.

DoPreUpgradeProcessing 함수는 전형적으로 AnswerFile에 대한 네트워크 컴포넌트의 pre-upgrade 매개변수 값들을 쓴다.

DoPreUpgradeProcessing 함수는 AnswerFile에 대한 다른 컴포넌트 특정 섹션들과 마찬가지로, 컴포넌트를 위한 OEM 섹션을 추가하기 위해 NetUpgradeAddSection 함수를 호출한다. DoPreUpgradeProcessing 함수는 NetSetup 함수에 의해 지정된 OEM 섹션 이름(szSectionName)을 사용해야 한다. DoPreUpgradeProcessing 함수는 AnswerFile내 센셕들에 대한 엔트리들을 추가하기 위해 요구된 만큼 여러번 NetUpgradeAddLineToSection 함수를 호출한다. AnswerFile 파일에 대한 네트워크 migration DLL에 의해 쓰여진 정보는 윈도우즈 이천 SetupXxx 함수들에 의해 읽혀질 수 있다.(SetupXxx 함수들에 대한 더 많은 정보는 Platform SDK 문서를 봐라.)

만약 네트워크 migration DLL이 네트워크 upgrade 프로세스의 GUI-mode phase동안 로드된다면, DoPreUpgradeProcessing 함수는 NUA_LOAD_POST_UPGRADE 플래그를 설정해야 한다. 이러한 플래그는 NetSetup에게 GUI-모드 phase동안 migration DLL을 로드하도록 한다.

DoPreUpgradeProcessing 함수는 업그레이드를 멈추게 하도록 사용자에게 prompt하는 메시지 박스를 표시하도록 NetSetup에게 지시하기 위해 NUA_REQUEST_ABORT_UPGRADE 플래그를 설정할 수 있다. 사용자는 이 요구를 override하고 업그레이드를 계속한다. 전형적으로, DoPreUpgradeProcessing 함수는 non-error 조건에 대한 응답으로 업그레이드 종료를 요구하기 위해 이러한 플래그를 설정할 수 있다.

만약 에러 조건이 발생한다면, DoPreUpgradeProcessing 함수는 실패의 이유를 지정하기 위해 Win32 에러 코드를 리턴해야 한다. 이것은 NetSetup에게 에러 메시지를 표시하도록 하고 네트워크 migration DLL 파일들을 지운다.

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