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

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

RequestAddress 메서드는 하나 이상의 멀티캐스트 주소에 대한 새 임대를 가져옵니다. EnumerateScopes 또는 get_Scopes 메서드를 먼저 호출해야 합니다.

구문

HRESULT RequestAddress(
  [in]  IMcastScope     *pScope,
  [in]  DATE            LeaseStartTime,
  [in]  DATE            LeaseStopTime,
  [in]  long            NumAddresses,
  [out] IMcastLeaseInfo **ppLeaseResponse
);

매개 변수

[in] pScope

애플리케이션에 주소가 필요한 멀티캐스트 scope 식별합니다. 애플리케이션은 먼저 get_Scopes 또는 EnumerateScopes 를 호출하여 사용 가능한 범위 목록을 가져옵니다.

[in] LeaseStartTime

이러한 주소에 대한 임대가 시작될 때까지 요청된 시간입니다. 실제로 부여된 시작 시간은 다를 수 있습니다.

[in] LeaseStopTime

이러한 주소에 대한 임대가 중지되도록 요청된 시간입니다. 실제로 부여된 중지 시간은 다를 수 있습니다.

[in] NumAddresses

요청된 주소 수입니다. 실제로 부여될 수 있는 주소는 더 적습니다.

[out] ppLeaseResponse

IMcastLeaseInfo 개체를 가리키도록 설정될 인터페이스 포인터에 대한 포인터입니다. 그런 다음 이 인터페이스를 사용하여 부여된 임대의 실제 특성을 검색할 수 있습니다. 자세한 내용은 IMcastScope 를 참조하세요.

반환 값

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

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

설명

이러한 COM 인터페이스와 해당 구현은 한 번에 여러 주소의 할당을 지원하지만 현재 기본 함수 호출에서는 여러 할당이 지원되지 않습니다. 여러 주소 할당에 루프를 사용해야 할 수 있습니다.

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

요구 사항

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

참고 항목

IMcastAddressAllocation