Método ITMediaCollection::Create
[ Controles e interfaces de conferência de telefonia ip de reunião não estão disponíveis para uso no Windows Vista, Windows Server 2008 e versões subsequentes do sistema operacional. A API do Cliente RTC fornece funcionalidade semelhante.]
O método Create cria uma nova mídia com propriedades padrão, adiciona-a à coleção no índice especificado e retorna um ponteiro para a interface ITMedia .
Sintaxe
HRESULT Create(
[in] LONG Index,
[out] ITMedia **ppMedia
);
Parâmetros
-
Índice [in]
-
Índice para o novo item. O valor mínimo para o índice é 1 e o valor máximo para o índice é o número atual de itens + 1.
-
ppMedia [out]
-
Ponteiro para a interface ITMedia criada.
Valor retornado
Esse método pode retornar um desses valores.
| Valor | Significado |
|---|---|
|
O método foi bem-sucedido. |
|
O parâmetro ppMedia não é um ponteiro válido. |
|
O parâmetro Index não é válido. |
|
Existe memória insuficiente para executar a operação. |
|
Erro não especificado. |
|
Este método ainda não foi implementado. |
Comentários
A maioria das listas C e C++ é baseada em 0, mas esse índice é baseado em 1 para compatibilidade com o Visual Basic, o que significa que o primeiro item tem um número de índice de 1.
O TAPI chama o método AddRef na interface ITMedia retornada por ITMediaCollection::Create. O aplicativo deve chamar Release na interface ITMedia para liberar recursos associados a ele.
Requisitos
| Requisito | Valor |
|---|---|
| Versão do TAPI |
Requer TAPI 3.0 ou posterior |
| Cabeçalho |
|
| Biblioteca |
|
| DLL |
|