Método IH323LineEx::SetDefaultCapabilityPreferrence

[SetDefaultCapabilityPreferrence não está disponível para uso no Windows Vista, Windows Server 2008 e versões subsequentes do sistema operacional. A API do Cliente RTC fornece funcionalidade semelhante.]

O método SetDefaultCapabilityPreferrence configura a preferência dos recursos padrão. Os recursos têm um peso padrão de 100. Se o aplicativo especificar um peso maior para uma funcionalidade, ele terá uma prioridade mais alta durante a negociação H.245. Se o aplicativo definir o peso de um recurso como 0, ele não será usado na negociação H.245.

Esse método é cumulativo. Por exemplo, se esse método for chamado primeiro para desabilitar um recurso e for chamado novamente para desabilitar outro, ambos os recursos serão desabilitados como resultado dessas duas chamadas.

Sintaxe

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

Parâmetros

dwNumCaps [in]

Um valor DWORD que contém o número de recursos definidos com esse método.

pCapabilities [in]

Uma matriz de recursos. Cada elemento da matriz é um valor H245_CAPABILITY .

pWeights [in]

Uma matriz de pesos associada aos recursos.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_OUTOFMEMORY	Existe memória insuficiente para executar a operação.
E_INVALIDARG	O parâmetro pCapabilities é NULL ou o parâmetro pWeights é NULL ou pCapabilities e pWeights são NULL ou a matriz pCapabilities contém um objeto de funcionalidade H.245 inválido.
E_POINTER	Não é possível ler um elemento da matriz pWeights ou um elemento da matriz pCapabilities .

Requisitos

Requisito	Valor
Versão do TAPI	Requer TAPI 3.0 ou posterior
Cabeçalho	H323priv.h
Biblioteca	Uuid.lib
DLL	Tapi3.dll