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 |
---|---|
|
Il metodo è riuscito. |
|
Il parametro ppMedia non è un puntatore valido. |
|
Il parametro Index non è valido. |
|
Memoria insufficiente per eseguire l'operazione. |
|
Errore non specificato. |
|
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 |
|
Libreria |
|
DLL |
|