다음을 통해 공유


IMcastLeaseInfo::get_RequestID 메서드(mdhcp.h)

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

get_RequestID 메서드는 임대에 대한 요청 ID를 가져옵니다. 이 메서드의 주요 목적은 애플리케이션이 종료된 후 요청 ID를 저장할 수 있도록 하여 IMcastAddressAllocation::CreateLeaseInfo 를 호출하여 후속 실행 중에 임대 정보 개체를 다시 만들 수 있도록 하는 것입니다. 이렇게 하면 원래 임대를 요청한 프로그램의 instance 종료된 후 임대를 갱신하거나 해제할 수 있습니다.

구문

HRESULT get_RequestID(
  [out] BSTR *ppRequestID
);

매개 변수

[out] ppRequestID

이 임대에 대한 요청 ID를 받을 BSTR 에 대한 포인터입니다. 요청 ID는 서버에 대한 이 임대 요청을 고유하게 식별합니다.

반환 값

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

반환 코드 설명
S_OK
메서드가 정상적으로 실행되었습니다.
S_FAIL
임대 정보 개체에 잘못된 요청 ID가 포함되어 있습니다.
E_POINTER
호출자가 잘못된 포인터 인수를 전달했습니다.
E_OUTOFMEMORY
BSTR을 할당할 메모리가 부족합니다.

설명

애플리케이션은 SysFreeString을 사용하여 ppRequestID 매개 변수에 할당된 메모리를 해제해야 합니다.

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

요구 사항

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

참고 항목

IMcastLeaseInfo