IRTCClientPortManagement::GetPortRange
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This method retrieves the minimum and maximum values of the port range configured for the specified port type. The port range is configured by the system administrator.
Syntax
HRESULT GetPortRange(
RTC_PORT_TYPE enPortType,
long* plMinValue,
long* plMaxValue
);
Parameters
- enPortType
[in] Pointer to an RTC_PORT_TYPE enumeration value specifying the port type for the retrieved range.
- plMinValue
[out] Pointer to the minimum port range value for the port type specified in enPortType from the registry.
- plMaxValue
[out] Pointer to the maximum port range value for the port type specified in enPortType from the registry.
Return Value
This method can return an RTC_E_ constant.
The following table shows additional possible return values.
| Value | Meaning |
|---|---|
E_INVALIDARG |
Invalid enumeration value. |
E_POINTER |
The pdwMaxValue or pdwMinValue parameter is not a valid pointer. |
Remarks
The range returned by this method is used while creating listening ports for media and SIP signaling traffic.
The values for the port ranges can be set in the registry under the registry key HKLM\Software\Policies\Microsoft\Windows\RTC\PortRange.
The MinSipDynamicPort and MaxSipDynamicPort values are used for setting the port range for SIP signaling traffic.
The MinMediaPort and MaxMediaPort values are used for setting the port range for audio/video RTP and RTCP traffic.
Requirements
| Header | rtccore.h, rtccore.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |