Método ITAddress::get_DialableAddress (tapi3if.h)

Artigo
08/26/2023

O método get_DialableAddress obtém o BSTR que pode ser usado para se conectar a esse endereço. O BSTR corresponde à cadeia de caracteres de endereço de destino que outro aplicativo usaria para se conectar a esse endereço, como um número de telefone ou um nome de email.

Sintaxe

HRESULT get_DialableAddress(
  [out] BSTR *pDialableAddress
);

Parâmetros

[out] pDialableAddress

Ponteiro para BSTR que contém a cadeia de caracteres de endereço discável. Isso corresponderá ao argumento pDestAddress de ITAddress::CreateCall.

Valor retornado

Esse método pode retornar um desses valores.

Valor	Significado
S_OK	O método foi bem-sucedido.
E_OUTOFMEMORY	Existe memória insuficiente para executar a operação.
E_POINTER	O parâmetro pDialableAddress não é um ponteiro válido.

Comentários

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

A disponibilidade desse valor depende do provedor de serviços. Por exemplo, em um endereço exposto pelo provedor de serviços Unimodem, esse método retornará uma cadeia de caracteres vazia em vez de um número de telefone.