Méthode IH323LineEx::SetDefaultCapabilityPreferrence
[SetDefaultCapabilityPreferrence n’est pas disponible pour une utilisation dans Windows Vista, Windows Server 2008 et les versions ultérieures du système d’exploitation. L’API cliente RTC fournit des fonctionnalités similaires.]
La méthode SetDefaultCapabilityPreferrence configure la préférence des fonctionnalités par défaut. Les fonctionnalités ont un poids par défaut de 100. Si l’application spécifie un poids plus élevé pour une fonctionnalité, elle aura une priorité plus élevée pendant la négociation H.245. Si l’application définit le poids d’une fonctionnalité sur 0, elle ne sera pas utilisée dans la négociation H.245.
Cette méthode est cumulative. Par exemple, si cette méthode est appelée en premier pour désactiver une fonctionnalité et qu’elle est appelée à nouveau pour en désactiver une autre, les deux fonctionnalités sont désactivées à la suite de ces deux appels.
Syntaxe
HRESULT SetDefaultCapabilityPreferrence(
[in] DWORD dwNumCaps,
[in] H245_CAPABILITY *pCapabilities,
[in] DWORD *pWeights
);
Paramètres
-
dwNumCaps [in]
-
Valeur DWORD qui contient le nombre de fonctionnalités définies avec cette méthode.
-
pCapabilities [in]
-
Tableau de fonctionnalités. Chaque élément du tableau est une valeur H245_CAPABILITY .
-
pWeights [in]
-
Tableau de pondérations associées aux fonctionnalités.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Code de retour | Description |
|---|---|
|
La méthode a réussi. |
|
La mémoire est insuffisante pour effectuer l’opération. |
|
Le paramètre pCapabilities est NULL, ou le paramètre pWeights a la valeur NULL, ou les deux pCapabilities et pWeights sont NULL, ou le tableau pCapabilities contient un objet de capacité H.245 non valide. |
|
Impossible de lire un élément du tableau pWeights ou un élément du tableau pCapabilities . |
Spécifications
| Condition requise | Valeur |
|---|---|
| Version TAPI |
Nécessite TAPI 3.0 ou version ultérieure |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|