PostUpgradeIntialize
LONG __stdcall
PostUpgradeInitialize(
IN PCWSTR swWorkingDir,
IN NetUpgradeInfo* pNetUpgradeInfo,
OUT VENDORINFO* pviVendorInfo,
OUT LPVOID pvReserved
);
|
만약 네트워크 migration DLL이 윈도우즈 이천 업그레이드의 GUI-모드 phase동안 호출된다면, PostUpgradeIntialize 함수를 제공해야 한다. PostUpgradeInitialize 함수는 업그레이드 환경에 대한 정보를 DLL에 제공한다. PostUpgradeInitialize 함수는 또한 벤더 정보를 NetSetup에 제공한다.
매개변수
- swWorkingDir
- 윈도우즈 이천 업그레이드의 Winnt32 phase동안 네트워크 migration DLL이 임시 파일들내에 저장한 디렉토리의 완전한 경로를 지정한다. 이 경로는 NetSetup이 DLL의 PreUpgradeInitialize 함수에 제공하는 같은 경로이다.
- pNetUpgradeInfo
- 업그레이드에 관련된 소스와 타켓 운영 체제들을 지정한다. 이 정보는 다음과 같이 정의된 NetUpgradeInfo 구조체로 포맷된다.
typdedef struct NetUpgradeInfo
{
ProductInfo From;
ProductInfo To;
};
이 구조체의 멤버들은 다음 데이터를 포함한다.
- From
- 컴포넌트가 업그레이드되는 것으로부터 운영 체제를 지정한다. 이 정보는 다음과 같이 정의된 ProductInfo 구조체로 포맷된다.
typedef struct ProductInfo
{
PRODUCTTYPE ProductType;
DWORD dwBuildNumber;
};
이 구조체의 멤버들은 다음 데이터를 포함한다.
- ProductType
- 컴포넌트가 다음과 같은 하나로 업그레이드되는 것으로부터 운영 체제를 지정한다.
- NT_SERVER
- 윈도우즈 NT 서버
- NT_WORKSTATION
- 윈도우즈 NT 워크스테이션
- UNKNOWN
- 알려지지 제품 타입
- dwBuildNumber
- 컴포넌트가 다음과 같은 하나로 업그레이드되는 것으로부터 운영 체제 시스템의 빌드 넘버를 지정한다.
- 1057
- 윈도우즈 NT 3.51
- 1381
- 윈도우즈 NT 4.0
- To
- 컴포넌트가 업그레이드되는 운영체제를 지정한다. 이 정보는 다음과 같이 정의된 ProductInfo 구조체로 포맷된다.
typedef struct ProductInfo
{
PRODUCTTYPE ProductType;
DWORD dwBuildNumber;
};
이 구조체의 멤버들은 다음 데이터를 포함한다.
- ProductType
- 컴포넌트가 다음과 같은 하나로 업그레이드되는 것으로부터 운영 체제를 지정한다.
- NT_SERVER
- 윈도우즈 NT 서버
- NT_WORKSTATION
- 윈도우즈 NT 워크스테이션
- UNKNOWN
- 알려지지 제품 타입
- dwBuildNumber
- 컴포넌트가 다음과 같은 하나로 업그레이드되는 것으로부터 운영 체제 시스템의 빌드 넘버를 지정한다.
- 1057
- 윈도우즈 NT 3.51
- 1381
- 윈도우즈 NT 4.0
- 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
- 예약
리턴값
PostUpgradeInitialize 함수는 다음과 같은 하나를 리턴할 수 있다.
- ERROR_SUCCESS
- migration DLL은 하나 혹은 그 이상 설치된 컴포넌트들을 발견했다.
- ERROR_XXX
- Win32 에러 코드. 그러한 에러 코드를 리턴하는 것은 NetSetup이 에러 메시지를 표시하게 하고 네트워크 migration DLL 파일들을 지우고 사용자에게 윈도우즈 이천 업그레이드를 종료하도록 prompt한다.
주석
NetSetup은 윈도우즈 이천 업그레이드의 GUI-mode phase동안 한번 네트워크 migration DLL의 PreUpgradeInitialize 함수를 호출한다. NetSetup은 DLL의 DoPostUpgradeProcessing 함수를 호출하기 전에 PreUpgradeInitialize 함수를 호출한다.
PostUpgradeInitialize 함수는 소스 운영 체제와 타켓 운영체제에 대한 정보를 네트워크 migration DLL에 제공한다. 특히 PostUpgradeInitialize 함수는 다음을 지정한다.
- 업그레이드되는 제품 타입(윈도우즈 NT 워크스테이션 혹은 윈도우즈 NT 서버)와 운영체제 빌드 넘버
- 업그레이드되는 제품 타입(윈도우즈 NT 워크스테이션 혹은 윈도우즈 NT 서버)와 운영체제(윈도우즈 이천) 빌드 넘버
PostUpgradeInitialize 함수는 또한 VENDORINFO 구조체로 포맷된 벤더 정보를 가리키는 NetSetup에 포인터(pviVendorInfo)를 제공한다. NetSetup은 만약 PostUpgradeIntialize 함수가 Win32 에러 코드를 리턴한다면 이러한 정보를 표시한다.
만약 에러가 발생하면, PostUpgradeIntialize 함수는 Win32에러 코드를 리턴한다. NetSetup은 사용자에게 에러를 보고하고 Upgrade DLL 파일들을 지우고 사용자에게 윈도우즈 이천의 설치를 그만두거나 계속할 것인지 물어본다.
|