Edit

IMcastLeaseInfo::get_RequestID method (mdhcp.h)

  • Article

[Rendezvous IP Telephony Conferencing controls and interfaces are not available for use in Windows Vista, Windows Server 2008, and subsequent versions of the operating system. The RTC Client API provides similar functionality.]

The get_RequestID method obtains the request ID for a lease. The primary purpose of this method is to allow you to save the request ID after your application exits, so that you can call IMcastAddressAllocation::CreateLeaseInfo to re-create the lease information object during a subsequent run. This allows you to renew or release a lease after the instance of your program that originally requested the lease has exited.

Syntax

HRESULT get_RequestID(
  [out] BSTR *ppRequestID
);

Parameters

[out] ppRequestID

Pointer to a BSTR that will receive the request ID for this lease. The request ID uniquely identifies this lease request to the server.

Return value

This method can return one of these values.

Return code Description
S_OK
 Method succeeded.
S_FAIL
 The lease information object contains an invalid request ID.
E_POINTER
 The caller passed in an invalid pointer argument.
E_OUTOFMEMORY
 Not enough memory to allocate the BSTR.

Remarks

The application must use SysFreeString to free the memory allocated for the ppRequestID parameter.

This function may send data over the wire in unencrypted form; therefore, someone eavesdropping on the network may be able to read the data. The security risk of sending the data in clear text should be considered before using this method.

Requirements

Requirement Value
Target Platform Windows
Header mdhcp.h
Library Uuid.lib
DLL Mdhcp.dll

See also

IMcastLeaseInfo