Função RasGetCountryInfoA (ras.h)

Artigo
11/20/2024

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 TAPI (Interface de Programação de Aplicativo de Telefonia) identificadores de país/região, 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 dwSize membro da estrutura como sizeof(RASCTRYINFO) para identificar a versão da estrutura. Além disso, defina o membro dwCountryId para 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.

Valor de retorno

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 dwCountryId membro da estrutura apontado 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 identificados 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.

Observações

Para enumerar informações para todos os países/regiões na lista de telefonia do Windows, defina o dwCountryId membro da estrutura de RASCTRYINFO como 1 na chamada de 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 dwNextCountryID membro é 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é dwNextCountryID retornar zero, indicando o último país/região na lista.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	ras.h
biblioteca	Rasapi32.lib
de DLL	Rasapi32.dll

Consulte também

RASCTRYINFO

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

Funções do Serviço de Acesso Remoto

Compartilhar via