ITMedia::put_TransportProtocol method

[ 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 put_TransportProtocol method sets the transport protocol. This is specified in addition to the media format so that the same standard media format may be carried over different transport protocols even when the network protocol is the same, such as with Vat PCM audio and RTP PCM audio.

Syntax

HRESULT put_TransportProtocol(
  [in] BSTR pProtocol
);

Parameters

pProtocol [in]

Pointer to a BSTR containing the transport protocol.

Return value

This method can return one of these values.

Return code Description
S_OK
Method succeeded.
E_POINTER
The pProtocol parameter is not a valid pointer.
E_OUTOFMEMORY
Insufficient memory exists to perform the operation.
E_FAIL
Unspecified error.
E_NOTIMPL
This method is not yet implemented.

Remarks

The application must use SysAllocString to allocate memory for the pProtocol parameter and use SysFreeString to free the memory when the variable is no longer needed.

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
TAPI version
Requires TAPI 3.0 or later
Header
Sdpblb.h
Library
Uuid.lib
DLL
Sdpblb.dll

See also

ITMedia

ITMedia::get_TransportProtocol