IMcastAddressAllocation::CreateLeaseInfoFromVariant 메서드(mdhcp.h)

[랑데부 IP 전화 회의 컨트롤 및 인터페이스는 Windows Vista, Windows Server 2008 및 운영 체제의 후속 버전에서 사용할 수 없습니다. RTC 클라이언트 API는 비슷한 기능을 제공합니다.]

CreateLeaseInfoFromVariant 메서드는 RenewAddress 또는 ReleaseAddress에 대한 후속 호출에 대한 임대 정보 개체를 만듭니다. 이 메서드는 CreateLeaseInfo 와 비슷하지만 Visual Basic과 같은 Automation 클라이언트 언어에서 사용됩니다.

구문

HRESULT CreateLeaseInfoFromVariant(
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  VARIANT         vAddresses,
  [in]  BSTR            pRequestID,
  [in]  BSTR            pServerAddress,
  [out] IMcastLeaseInfo **ppReleaseRequest
);

매개 변수

[in] LeaseStartTime

임대의 시작 시간입니다.

[in] LeaseStopTime

임대 중지 시간입니다.

[in] vAddresses

BSTR 문자열의 SAFEARRAY를 포함하는 VARIANT입니다. 각 BSTR 은 점선 쿼드 표기법의 IP 버전 4 주소입니다(예: 10.111.222.111).

[in] pRequestID

원래 요청에 대한 요청 ID를 지정하는 BSTR 에 대한 포인터입니다. 이는 원래 요청에 해당하는 임대 정보 개체에서 IMcastLeaseInfo::get_RequestID 호출하여 가져옵니다. 요청 ID는 애플리케이션 프로그램을 실행하는 동안 영구 스토리지에 저장해야 합니다. 동일한 애플리케이션 실행 중에 요청된 임대를 갱신하거나 해제하는 경우 CreateLeaseInfo를 사용할 이유가 없습니다. 기존 IMcastLeaseInfo 포인터를 RenewAddress 또는 ReleaseAddress에 전달하기만 하면됩니다.

[in] pServerAddress

서버 주소를 지정하는 BSTR 에 대한 포인터입니다.

[out] ppReleaseRequest

만든 IMcastLeaseInfo 인터페이스에 대한 포인터입니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

의미
S_OK
메서드가 정상적으로 실행되었습니다.
E_POINTER
호출자가 잘못된 포인터 인수를 전달했습니다.
E_OUTOFMEMORY
필요한 개체를 만들기에 충분한 메모리가 없습니다.

설명

애플리케이션은 SysAllocString을 사용하여 pRequestIDpServerAddress 매개 변수에 대한 메모리를 할당해야 합니다. 애플리케이션은 변수가 더 이상 필요하지 않을 때 SysFreeString 을 사용하여 메모리를 해제해야 합니다.

TAPI는 IMcastAddressAllocation::CreateLeaseInfoFromVariant에서 반환된 IMcastLeaseInfo 인터페이스에서 AddRef 메서드를 호출합니다. 애플리케이션은 IMcastLeaseInfo 인터페이스에서 Release를 호출하여 연결된 리소스를 해제해야 합니다.

이 함수는 암호화되지 않은 형태로 유선으로 데이터를 보낼 수 있습니다. 따라서 네트워크에서 도청하는 사람이 데이터를 읽을 수 있습니다. 이 메서드를 사용하기 전에 데이터를 명확한 텍스트로 보낼 때의 보안 위험을 고려해야 합니다.

요구 사항

   
대상 플랫폼 Windows
헤더 mdhcp.h
라이브러리 Uuid.lib
DLL Mdhcp.dll

참고 항목

IMcastAddressAllocation

IMcastLeaseInfo