IH323LineEx::SetDefaultCapabilityPreferrence method
[SetDefaultCapabilityPreferrence is 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 SetDefaultCapabilityPreferrence method configures the preference of the default capabilities. Capabilities have a default weight of 100. If the application specifies a higher weight for a capability, it will have a higher priority during the H.245 negotiation. If the application sets the weight of a capability to 0, it will not be used in the H.245 negotiation.
This method is cumulative. For example, if this method is called first to disable a capability and is called again to disable another, both capabilities will be disabled as the result of these two calls.
Syntax
HRESULT SetDefaultCapabilityPreferrence(
[in] DWORD dwNumCaps,
[in] H245_CAPABILITY *pCapabilities,
[in] DWORD *pWeights
);
Parameters
-
dwNumCaps [in]
-
A DWORD value that contains the number of capabilities set with this method.
-
pCapabilities [in]
-
An array of capabilities. Each element of the array is an H245_CAPABILITY value.
-
pWeights [in]
-
An array of weights associated with the capabilities.
Return value
This method can return one of these values.
| Return code | Description |
|---|---|
|
Method succeeded. |
|
Insufficient memory exists to perform the operation. |
|
The pCapabilities parameter is NULL, or the pWeights parameter is NULL, or both pCapabilities and pWeights are NULL, or the pCapabilities array contains an invalid H.245 capability object. |
|
Unable to read an element of the pWeights array or an element of the pCapabilities array. |
Requirements
| Requirement | Value |
|---|---|
| TAPI version |
Requires TAPI 3.0 or later |
| Header |
|
| Library |
|
| DLL |
|