PreUpgradeInitialize
LONG __stdcall
PreUpgradeInitialize(
IN PCWSTR swWorkingDir,
IN NetUpgradeInfo* pNetUpgradeInfo,
OUT VENDORINFO* pviVendorInfo,
OUT DWORD* pdwFlags,
OUT NetUpgradeData* pNetUpgradeData
);
|
네트워크 migration DLL은 PreUpgradeInitialize 함수를 제공해야 한다. PreUpgradeInitialize 함수는 DLL에 업그레이드 환경에 대한 정보를 제공한다. PreUpgradeInitialize 함수는 또한 NetSetup에게 벤더 정보를 제공하고 NetSetup이 사용자가 윈도우즈 이천 업그레이드를 abort하도록 prompt하는 메시지를 디스플레이하도록 할 수 있다.
매개변수
- swWorkingDir
- 네트워크 migration DLL이 임시 파일들내에 저장해야 하는 디렉토리의 완전한 경로를 지정한다. DLL은 DLL이 업그레이드의 GUI-mode phase내 실행하는 이러한 디렉토리를 접근할 수 있을 것이다.
- 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에 속한 추가적인 명령어들을 지정한다.
- pdwFlags
- 다음과 같은 하나로 지정한다.
| 값 |
의미 |
| zero |
어떠한 행동을 하라고 NetSetup에게 요구하지 않는다. |
| NUA_REQUEST_ABORT_UPGRADE |
사용자에게 업그레이드를 그만두도록 prompt하는 메시지 박스를 표시하도록 NetSetup에게 요구한다. |
- pNetUpgradeData
- NetSetup이 운영체제를 업그레이드 하기 전에 지울 수 없는 서비스들을 지정한다. 이 정보는 다음과 같이 정의된 NetUpgradeDataTag 구조체로 포맷된다. :
typedef struct NetUpgradeDataTag
{
LPTSTR mszServicesNotToBeDeleted;
}NetUpgradeData;
이러한 구조체의 멤버는 다음과 같은 데이터를 포함한다.
- mszServicesNotToBeDeleted
- 서비스들의 리스트를 지정하는 MULTI_SZ 값. 이러한 리스트내 각 엔트리는 업그레이드 프로세스동안 NetSetup에 의해 지울 수 없는 서비스를 지정한다. 모든 다른 서비스들은 (mszServicesNotToBeDeleted내 리스트되지 않는 것들) 지워질 것이고 그리고 나서 업그레이드 프로세스동안 NetSetup에 의해 다시 인스톨된다.
리턴값
PreUpgradeInitialize 함수는 다음과 같은 하나를 리턴할 수 있다.
- ERROR_SUCCESS
- migration DLL은 하나 혹은 그 이상 설치된 컴포넌트들을 발견했다.
- ERROR_XXX
- Win32 에러 코드. 그러한 에러 코드를 리턴하는 것은 NetSetup이 에러 메시지를 표시하게 하고 네트워크 migration DLL 파일들을 지우고 사용자에게 윈도우즈 이천 업그레이드를 종료하도록 prompt한다.
주석
NetSetup은 윈도우즈 이천 업그레이드의 Winnt32 phase동안 한번 네트워크 migration DLL의 PreUpgradeInitialize 함수를 호출한다. NetSetup은 DLL의 DoPreUpgradeProcessing 함수를 호출하기 전에 PreUpgradeInitialize 함수를 호출한다.
PreUpgradeInitialize 함수는 소스 운영 체제와 타켓 운영체제에 대한 정보를 네트워크 migration DLL에 제공한다. 특히 PreUpgradeInitialize 함수는 다음을 지정한다.
- 업그레이드되는 제품 타입(윈도우즈 NT 워크스테이션 혹은 윈도우즈 NT 서버)와 운영체제 빌드 넘버
- 업그레이드되는 제품 타입(윈도우즈 NT 워크스테이션 혹은 윈도우즈 NT 서버)와 운영체제(윈도우즈 이천) 빌드 넘버
PreUpgradeInitialize 함수는 또한 VENDORINFO 구조체로 포맷된 벤더 정보를 가리키는 NetSetup에 포인터(pviVendorInfo)를 제공한다. NetSetup은 만약 PreUpgradeIntialize 함수가 Win32 에러 코드를 리턴한다면 이러한 정보를 표시한다.
만약 에러가 발생하면, PreUpgradeIntialize 함수는 Win32에러 코드를 리턴한다. NetSetup은 사용자에게 에러를 보고하고 Upgrade DLL 파일들을 지우고 사용자에게 윈도우즈 이천의 설치를 그만두거나 계속할 것인지 물어본다.
|