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
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro ppMedia não é um ponteiro válido.
E_INVALIDARG	O parâmetro Index não é válido.
E_OUTOFMEMORY	Existe memória insuficiente para executar a operação.
E_FAIL	Erro não especificado.
E_NOTIMPL	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	Sdpblb.h
Biblioteca	Uuid.lib
DLL	Sdpblb.dll

Confira também

Itmedia

ITMediaCollection