Compartilhar via

Método ITAddressCapabilities::get_AddressCapabilityString (tapi3if.h)

  • Artigo

O método get_AddressCapabilityString obtém a cadeia de caracteres de funcionalidade para um determinado ADDRESS_CAPABILITY_STRING.

Sintaxe

HRESULT get_AddressCapabilityString(
  [in]  ADDRESS_CAPABILITY_STRING AddressCapString,
  [out] BSTR                      *ppCapabilityString
);

Parâmetros

[in] AddressCapString

Descritor para a cadeia de caracteres de funcionalidade de endereço desejada.

[out] ppCapabilityString

Ponteiro para o valor BSTR da funcionalidade de endereço. NULL é um valor retornado possível se o TSP não fornecer um valor para AddressCapString.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
E_INVALIDARG
 O parâmetro AddressCapString não é válido.
E_POINTER
 O parâmetro ppCapabilityString não é um ponteiro válido.
TAPI_E_NOTSUPPORTED
 A versão do TAPI não é 3.0 ou superior.
E_OUTOFMEMORY
 Há memória insuficiente para executar a operação.

Comentários

O aplicativo deve usar SysFreeString para liberar a memória alocada para o parâmetro ppCapabilityString .

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho tapi3if.h (inclua Tapi3.h)
Biblioteca Uuid.lib
DLL Tapi3.dll

Confira também

ADDRESS_CAPABILITY_STRING

Objeto Address

ITAddressCapabilities