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 nicht in der H.245-Aushandlung 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 mit dieser Methode festgelegten Funktionen enthält.

pCapabilities [ In]

Ein Array von Funktionen. Jedes Element des Arrays ist ein H245 _ CAPABILITY-Wert.

pWeights [ 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
Es ist nicht genügend Arbeitsspeicher zum Ausführen des Vorgangs 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 eines Elements 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