Função RasGetCountryInfoA (ras.h)

  • Artigo

A função RasGetCountryInfo recupera informações de discagem específicas do país/região da lista de países/regiões da Telefonia do Windows.

Para obter mais informações sobre informações de discagem específicas do país/região e identificadores de país/região da TAPI (Interface de Programação de Aplicativo de Telefonia), consulte a parte TAPI do SDK (Platform Software Development Kit).

Sintaxe

DWORD RasGetCountryInfoA(
  [in, out] LPRASCTRYINFOA unnamedParam1,
  [in, out] LPDWORD        unnamedParam2
);

Parâmetros

[in, out] unnamedParam1

Ponteiro para uma estrutura RASCTRYINFO que, na saída, recebe as informações de discagem específicas do país/região seguidas por bytes adicionais para uma cadeia de caracteres de descrição de país/região.

Na entrada, defina o membro dwSize da estrutura como sizeof (RASCTRYINFO) para identificar a versão da estrutura. Além disso, defina o membro dwCountryId como o identificador de país/região TAPI do país/região para o qual obter informações.

Aloque pelo menos 256 bytes para o buffer.

[in, out] unnamedParam2

Ponteiro para uma variável que, na entrada, especifica o tamanho, em bytes, do buffer apontado pelo parâmetro lpRasCtryInfo .

Na saída, essa variável recebe o número de bytes necessários.

Retornar valor

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado será um dos seguintes códigos de erro ou um valor de Códigos de Erro de Roteamento e Acesso Remoto ou Winerror.h.

Valor Significado
ERROR_INVALID_USER_BUFFER
 O endereço ou buffer especificado por lpRasCtryInfo é inválido.
ERROR_INVALID_PARAMETER
 O membro dwCountryId da estrutura apontada por lpRasCtryInfo não era um valor válido.
ERROR_BUFFER_TOO_SMALL
 O tamanho do buffer lpRasCtryInfo especificado pelo parâmetro lpdwSize não era grande o suficiente para armazenar as informações para o país/região identificado pelo membro dwCountryId . A função retorna o tamanho do buffer necessário na variável apontada por lpdwSize.
ERROR_TAPI_CONFIGURATION
 As informações do subsistema TAPI foram corrompidas.

Comentários

Para enumerar informações para todos os países/regiões na lista telefonia do Windows, defina o membro dwCountryId da estrutura RASCTRYINFO como 1 na chamada rasGetCountryInfo inicial. Isso faz com que a função retorne informações para o primeiro país/região da lista. O valor retornado no membro dwNextCountryID é o identificador de país/região do próximo país/região na lista. Use esse valor em chamadas repetidas para RasGetCountryInfo até que dwNextCountryID retorne zero, indicando o último país/região na lista.

Observação

O cabeçalho ras.h define RasGetCountryInfo como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ras.h
Biblioteca Rasapi32.lib
DLL Rasapi32.dll

Confira também

RASCTRYINFO

Visão geral do RAS (Serviço de Acesso Remoto)

Funções do serviço de acesso remoto