HrGetInstanceGuidOfPreNT5NetCardInstance

LONG __stdcall HrGetInstanceGuidOfPreNT5NetCardInstance( IN PCWSTR szPreNt5NetCardInstance, OUT LPGUID pguid );

HrGetInstanceGuidOfPreNT5NetCardInstance 함수는 네트워크 어댑터의 globally unique indentifier(GUID)로 네트워크 migration DLL을 제공한다.

매개변수

szPreNt5NetCardInstance

어댑터를 위한 서비스(장치 드라이버)의 pre-upgrade 인스턴스. szPreNt5NetCardInstance는 일반적으로 인스턴스 넘버가 뒤에 오는 서비스 이름으로 구성한다.

pguid

만약 szPreNt5NetCardInstance가 업그레이드하기 전 존재하고 post-upgrade 인스턴스에 맵될 수 있다면, pguid는 어댑터를 위한 post-upgrade 인스턴스 GUID를 가리킨다. 만약 그렇지 않으면, pguid는 0이다.

리턴값

HrGetInstanceGuidOfPreNT5NetCardInstance는 다음과 같은 하나로 리턴할 수 있다.

ERROR_SUCCESS

HrGetInstanceGuidOfPreNT5NetCardInstance는 유효한 pguid 값을 리턴된다.

ERROR_INVALID_PARAMETER

szPreNt5NetCardInstance가 유효하지 않다.

어떤 다른 리턴 값들은 szPreNt5NetCardInstance가 윈도우즈 이천 인스턴스 GUID로 맵 될 수 없다는 것을 가리킨다.

주석

네트워크 migration DLL은 DLL의 DoPostUpgradeProcessing 함수에서 HrGetInstanceGuidOfPreNt5NetCardInstance 함수를 호출해야 한다.

만약 네트워크 어댑터를 위해 미니포트 드라이버는 윈도우즈 이천 업그레이드하기 전에 어댑터의 인스턴스 ID를 요구한다면, 아마 업그레이드 후, 어댑터의 인스턴스 ID를 요구할 것이다. 네트워크 migration DLL이 네트워크 어댑터를 위해 윈도우즈 이천 인스턴스 GUID를 얻기 위해 HrGetInstanceGuidOfPreNT5NetCardInstance 함수를 호출한다.