IH323LineEx::SetDefaultCapabilityPreferrence-Methode

[SetDefaultCapabilityPreferrence ist nicht für die Verwendung in Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems verfügbar. Die RTC-Client-API bietet ähnliche Funktionen.]

Die SetDefaultCapabilityPreferrence-Methode konfiguriert die Einstellung der Standardfunktionen. Funktionen haben eine Standardgewichtung von 100. Wenn die Anwendung eine höhere Gewichtung für eine Funktion angibt, hat sie während der H.245-Aushandlung eine höhere Priorität. Wenn die Anwendung die Gewichtung einer Funktion auf 0 festlegt, wird sie in der H.245-Aushandlung nicht verwendet.

Diese Methode ist kumulativ. Wenn diese Methode beispielsweise zuerst aufgerufen wird, um eine Funktion zu deaktivieren, und erneut aufgerufen wird, um eine andere zu deaktivieren, werden beide Funktionen als Ergebnis dieser beiden Aufrufe deaktiviert.

Syntax

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

Parameter

dwNumCaps [in]

Ein DWORD-Wert , der die Anzahl der funktionen enthält, die mit dieser Methode festgelegt wurden.

pCapabilities [in]

Ein Array von Funktionen. Jedes Element des Arrays ist ein H245_CAPABILITY Wert.

pGewichte [in]

Ein Array von Gewichtungen, die den Funktionen zugeordnet sind.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Methode war erfolgreich.
E_OUTOFMEMORY	Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden.
E_INVALIDARG	Der pCapabilities-Parameter ist NULL, oder der pWeights-Parameter ist NULL, oder pCapabilities und pWeights sind NULL, oder das pCapabilities-Array enthält ein ungültiges H.245-Funktionsobjekt.
E_POINTER	Ein Element des pWeights-Arrays oder ein Element des pCapabilities-Arrays kann nicht gelesen werden.

Anforderungen

Anforderung	Wert
TAPI-Version	Erfordert TAPI 3.0 oder höher
Header	H323priv.h
Bibliothek	Uuid.lib
DLL	Tapi3.dll