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는 서버에 대한 이 임대 요청을 고유하게 식별합니다.
반환 값
이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.
반환 코드 | 설명 |
---|---|
|
메서드가 정상적으로 실행되었습니다. |
|
임대 정보 개체에 잘못된 요청 ID가 포함되어 있습니다. |
|
호출자가 잘못된 포인터 인수를 전달했습니다. |
|
BSTR을 할당할 메모리가 부족합니다. |
설명
애플리케이션은 SysFreeString을 사용하여 ppRequestID 매개 변수에 할당된 메모리를 해제해야 합니다.
이 함수는 암호화되지 않은 형식으로 와이어를 통해 데이터를 보낼 수 있습니다. 따라서 네트워크에서 도청하는 사용자가 데이터를 읽을 수 있습니다. 이 메서드를 사용하기 전에 데이터를 명확한 텍스트로 보내는 보안 위험을 고려해야 합니다.
요구 사항
대상 플랫폼 | Windows |
헤더 | mdhcp.h |
라이브러리 | Uuid.lib |
DLL | Mdhcp.dll |