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

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

CreateLeaseInfo 메서드는 RenewAddress 또는 ReleaseAddress에 대한 후속 호출에 대한 임대 정보 개체를 만듭니다.

구문

HRESULT CreateLeaseInfo(
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  DWORD           dwNumAddresses,
  [in]  LPWSTR          *ppAddresses,
  [in]  LPWSTR          pRequestID,
  [in]  LPWSTR          pServerAddress,
  [out] IMcastLeaseInfo **ppReleaseRequest
);

매개 변수

[in] LeaseStartTime

임대의 시작 시간입니다.

[in] LeaseStopTime

임대 중지 시간입니다.

[in] dwNumAddresses

임대와 연결된 주소 수입니다.

[in] ppAddresses

크기 dwNumAddresses의 LPWSTR 포인터 배열입니다. 각 LPWSTR 은 점선 쿼드 표기법의 IP 버전 4 주소입니다(예: 10.111.222.111).

[in] pRequestID

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

[in] pServerAddress

서버 주소를 지정합니다.

[out] ppReleaseRequest

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

반환 값

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

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

설명

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

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

요구 사항

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

참고 항목

IMcastAddressAllocation