IClassFactory2::RequestLicKey 메서드(ocidl.h)

호출자가 저장하고 나중에 사용이 허가된 개체의 instance 만드는 데 사용할 수 있는 라이선스 키를 만듭니다.

구문

HRESULT RequestLicKey(
  [in]  DWORD dwReserved,
  [out] BSTR  *pBstrKey
);

[in] dwReserved

이 매개 변수는 예약되어 있으며 0이어야 합니다.

[out] pBstrKey

이 메서드에서 성공적으로 반환될 때 호출 수신자가 할당한 라이선스 키를 수신하는 호출자 할당 변수에 대한 포인터입니다. 이 매개 변수는 실패 시 NULL 로 설정됩니다.

이 메서드는 다음 값뿐만 아니라 E_INVALIDARG, E_OUTOFMEMORY 및 E_UNEXPECTED 표준 반환 값을 반환할 수 있습니다.

반환 코드	Description
S_OK	라이선스 키가 성공적으로 만들어졌습니다.
E_NOTIMPL	이 클래스 팩터리는 런타임 라이선스 키를 지원하지 않습니다.
E_POINTER	pbstrKey에 전달된 주소가 잘못되었습니다. 예를 들어 NULL일 수 있습니다.
CLASS_E_NOTLICENSED	이 클래스 팩터리는 런타임 라이선스를 지원하지만 현재 컴퓨터 자체는 라이선스가 없습니다. 따라서 런타임 키는 이 컴퓨터에서 사용할 수 없습니다.

호출자는 IClassFactory2::CreateInstanceLic 에 대한 후속 호출에 대한 라이선스 키를 저장하여 허가되지 않은 컴퓨터에 개체를 만들 수 있습니다.

호출자는 키가 더 이상 필요하지 않은 경우 SysFreeString 함수를 사용하여 BSTR을 해제해야 합니다. fRuntimeKeyAvail 값은 IClassFactory2::GetLicInfo에 대한 이전 호출을 통해 반환됩니다.

이 메서드는 SysAllocString 또는 SysAllocStringLen을 사용하여 BSTR 키를 할당하고 이 메서드가 성공적으로 반환된 후 호출자가 이 BSTR을 담당하게 됩니다.

클래스 팩터리에서 런타임 라이선스 키를 지원하지 않는 경우 이 메서드를 구현할 필요가 없습니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	ocidl.h