ITMediaCollection::Create, méthode
[ Les contrôles et interfaces de conférence de téléphonie IP rendez-vous ne sont pas disponibles 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 Create crée un média avec des propriétés par défaut, l’ajoute à la collection à l’index spécifié et retourne un pointeur vers l’interface ITMedia .
Syntaxe
HRESULT Create(
[in] LONG Index,
[out] ITMedia **ppMedia
);
Paramètres
-
Index [in]
-
Index du nouvel élément. La valeur minimale de l’index est 1, et la valeur maximale de l’index est le nombre actuel d’éléments + 1.
-
ppMedia [out]
-
Pointeur vers l’interface ITMedia créée.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
| Valeur | Signification |
|---|---|
|
La méthode a réussi. |
|
Le paramètre ppMedia n’est pas un pointeur valide. |
|
Le paramètre Index n’est pas valide. |
|
La mémoire est insuffisante pour effectuer l’opération. |
|
Erreur non spécifiée. |
|
Cette méthode n'est pas encore implémentée. |
Notes
La plupart des listes C et C++ sont basées sur 0, mais cet index est basé sur 1 pour la compatibilité Visual Basic, ce qui signifie que le premier élément a un numéro d’index de 1.
TAPI appelle la méthode AddRef sur l’interface ITMedia retournée par ITMediaCollection::Create. L’application doit appeler Release sur l’interface ITMedia pour libérer les ressources qui lui sont associées.
Spécifications
| Condition requise | Valeur |
|---|---|
| Version TAPI |
Nécessite TAPI 3.0 ou version ultérieure |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|