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 |
|---|---|
|
Methode war erfolgreich. |
|
Es ist nicht genügend Arbeitsspeicher zum Ausführen des Vorgangs vorhanden. |
|
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. |
|
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 |
|
| Bibliothek |
|
| DLL |
|