Metodo IH323LineEx::SetDefaultCapabilityPreferrence

[SetDefaultCapabilityPreferrence non è disponibile per l'uso in Windows Vista, Windows Server 2008 e versioni successive del sistema operativo. L'API client RTC offre funzionalità simili.

Il metodo SetDefaultCapabilityPreferrence configura la preferenza delle funzionalità predefinite. Le funzionalità hanno un peso predefinito di 100. Se l'applicazione specifica un peso maggiore per una funzionalità, avrà una priorità maggiore durante la negoziazione H.245. Se l'applicazione imposta il peso di una funzionalità su 0, non verrà usato nella negoziazione H.245.

Questo metodo è cumulativo. Ad esempio, se questo metodo viene chiamato prima per disabilitare una funzionalità e viene chiamato di nuovo per disabilitare un altro, entrambe le funzionalità verranno disabilitate come risultato di queste due chiamate.

Sintassi

HRESULT SetDefaultCapabilityPreferrence(
  [in] DWORD           dwNumCaps,
  [in] H245_CAPABILITY *pCapabilities,
  [in] DWORD           *pWeights
);

Parametri

dwNumCaps [in]

Valore DWORD contenente il numero di funzionalità impostate con questo metodo.

pCapabilities [in]

Matrice di funzionalità. Ogni elemento della matrice è un valore H245_CAPABILITY .

pWeights [in]

Matrice di pesi associati alle funzionalità.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione.
E_INVALIDARG	Il parametro pCapabilities è NULL o il parametro pWeights è NULL o sia pCapabilities che pWeights sono NULL o la matrice pCapabilities contiene un oggetto di funzionalità H.245 non valido.
E_POINTER	Impossibile leggere un elemento della matrice pWeights o un elemento della matrice pCapabilities .

Requisiti

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