Função RasGetCountryInfoA (ras.h)
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 |
---|---|
|
O endereço ou buffer especificado por lpRasCtryInfo é inválido. |
|
O membro dwCountryId da estrutura apontada por lpRasCtryInfo não era um valor válido. |
|
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. |
|
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
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de