Metodo ITMediaCollection::Create

[ I controlli e le interfacce di telefonia IP rendezvous non sono disponibili per l'uso in Windows Vista, Windows Server 2008 e versioni successive del sistema operativo. L'API client RTC offre funzionalità simili.

Il metodo Create crea un nuovo supporto con proprietà predefinite, lo aggiunge alla raccolta all'indice specificato e restituisce un puntatore all'interfaccia ITMedia .

Sintassi

HRESULT Create(
  [in]  LONG    Index,
  [out] ITMedia **ppMedia
);

Parametri

Indice [in]

Indice per il nuovo elemento. Il valore minimo per l'indice è 1 e il valore massimo per l'indice è il numero corrente di elementi + 1.

ppMedia [out]

Puntatore all'interfaccia ITMedia creata.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro ppMedia non è un puntatore valido.
E_INVALIDARG	Il parametro Index non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.
E_FAIL	Errore non specificato.
E_NOTIMPL	Questo metodo non è ancora implementato.

Commenti

La maggior parte degli elenchi C e C++ è basata su 0, ma questo indice è basato su 1 per la compatibilità di Visual Basic, il che significa che il primo elemento ha un numero di indice pari a 1.

TAPI chiama il metodo AddRef nell'interfaccia ITMedia restituita da ITMediaCollection::Create. L'applicazione deve chiamare Release nell'interfaccia ITMedia per liberare risorse associate.

Requisiti

Requisito	Valore
Versione TAPI	Richiede TAPI 3.0 o versione successiva
Intestazione	Sdpblb.h
Libreria	Uuid.lib
DLL	Sdpblb.dll

Vedi anche

ITMedia

ITMediaCollection