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 를 참조하세요.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
| 값 | 의미 |
|---|---|
|
메서드가 정상적으로 실행되었습니다. |
|
호출자가 잘못된 포인터 인수를 전달했습니다. |
|
필요한 개체를 만들기 위한 메모리가 부족합니다. |
|
요청된 중지 시간은 요청된 중지 시간 이전입니다. |
설명
이러한 COM 인터페이스와 해당 구현은 한 번에 여러 주소의 할당을 지원하지만 현재 기본 함수 호출에서는 여러 할당이 지원되지 않습니다. 여러 주소 할당에 루프를 사용해야 할 수 있습니다.
TAPI는 IMcastAddressAllocation::RequestAddress에서 반환된 IMcastLeaseInfo 인터페이스에서 AddRef 메서드를 호출합니다. 애플리케이션은 IMcastLeaseInfo 인터페이스에서 Release를 호출하여 연결된 리소스를 해제해야 합니다.
요구 사항
| 대상 플랫폼 | Windows |
| 헤더 | mdhcp.h |
| 라이브러리 | Uuid.lib |
| DLL | Mdhcp.dll |