Método IH323LineEx::SetDefaultCapabilityPreferrence

[SetDefaultCapabilityPreferrence no está disponible para su uso en Windows Vista, Windows Server 2008 y versiones posteriores del sistema operativo. La API de cliente RTC proporciona una funcionalidad similar.]

El método SetDefaultCapabilityPreferrence configura la preferencia de las funcionalidades predeterminadas. Las funcionalidades tienen un peso predeterminado de 100. Si la aplicación especifica un peso mayor para una funcionalidad, tendrá una prioridad más alta durante la negociación H.245. Si la aplicación establece el peso de una funcionalidad en 0, no se usará en la negociación H.245.

Este método es acumulativo. Por ejemplo, si se llama primero a este método para deshabilitar una funcionalidad y se llama de nuevo para deshabilitar otra, ambas funcionalidades se deshabilitarán como resultado de estas dos llamadas.

Sintaxis

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

Parámetros

dwNumCaps [in]

Valor DWORD que contiene el número de funcionalidades establecidas con este método.

pCapabilities [in]

Matriz de funcionalidades. Cada elemento de la matriz es un valor H245_CAPABILITY .

pWeights [in]

Matriz de pesos asociados a las funcionalidades.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
E_OUTOFMEMORY	Existe memoria insuficiente para realizar la operación.
E_INVALIDARG	El parámetro pCapabilities es NULL o el parámetro pWeights es NULL, o bien pCapabilities y pWeights son NULL o la matriz pCapabilities contiene un objeto de funcionalidad H.245 no válido.
E_POINTER	No se puede leer un elemento de la matriz pWeights o un elemento de la matriz pCapabilities .

Requisitos

Requisito	Value
Versión de TAPI	Requiere TAPI 3.0 o posterior
Encabezado	H323priv.h
Biblioteca	Uuid.lib
Archivo DLL	Tapi3.dll