Função RasGetAutodialAddressA (ras.h)

  • Artigo

A função RasGetAutodialAddress recupera informações sobre todas as entradas do AutoDial associadas a um endereço de rede no banco de dados de mapeamento do AutoDial.

Sintaxe

DWORD RasGetAutodialAddressA(
  [in]      LPCSTR              unnamedParam1,
  [in]      LPDWORD             unnamedParam2,
  [in, out] LPRASAUTODIALENTRYA unnamedParam3,
  [in, out] LPDWORD             unnamedParam4,
  [out]     LPDWORD             unnamedParam5
);

Parâmetros

[in] unnamedParam1

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o endereço para o qual as informações são solicitadas. Pode ser um endereço IP, um nome de host da Internet ("www.microsoft.com" ou um nome NetBIOS ("products1").

Se esse parâmetro for NULL, a função recuperará a conexão de Internet padrão. A função retornará a conexão de Internet padrão por usuário se uma estiver configurada. Caso contrário, a função retornará a conexão de Internet padrão global. Se nenhuma conexão de Internet padrão estiver configurada, a função retornará zero para os parâmetros lpdwcbAutoDialEntries e lpdwcAutoDialEntries .

[in] unnamedParam2

Reservados; deve ser NULL.

[in, out] unnamedParam3

Ponteiro para um buffer que, na saída, recebe uma matriz de estruturas RASAUTODIALENTRY , uma para cada entrada de AutoDial associada ao endereço especificado pelo parâmetro lpszAddress .

Na entrada, defina o membro dwSize da primeira estrutura RASAUTODIALENTRY no buffer como sizeof(RASAUTODIALENTRY) para identificar a versão da estrutura.

Se lpAutoDialEntries for NULL, RasGetAutodialAddress definirá os parâmetros lpdwcbAutoDialEntries e lpdwcAutoDialEntries para indicar o tamanho do buffer necessário, em bytes e o número de entradas de AutoDial.

[in, out] unnamedParam4

Ponteiro para uma variável que, na entrada, especifica o tamanho, em bytes, do buffer lpAutoDialEntries .

Na saída, essa variável recebe o número de bytes retornados ou o número de bytes necessários se o buffer for muito pequeno.

[out] unnamedParam5

Ponteiro para uma variável que recebe o número de elementos de estrutura retornados no buffer lpAutoDialEntries .

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_SIZE
 O membro dwSize da estrutura RASAUTODIALENTRY é um valor inválido.
ERROR_INVALID_PARAMETER
 O parâmetro lpszAddress, lpdwcbAutoDialEntries ou lpdwcAutoDialEntries era NULL.

Comentários

O RAS (Serviço de Acesso Remoto) dá suporte a conexões de Internet padrão. O RAS dá suporte a uma conexão de Internet padrão global para o computador local e, além disso, dá suporte a uma conexão de Internet padrão para cada usuário.

O nome da conexão de Internet padrão global é armazenado no registro abaixo da seguinte chave do Registro:

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Ras Autodial
            Default

O valor que armazena o nome da conexão é:

DefaultInternet

Esse valor é do tipo REG_SZ.

A conexão de Internet padrão global deve ser configurada como uma conexão para todos os usuários na interface do usuário da Pasta Connections.

O nome da conexão de Internet padrão por usuário é armazenado no registro abaixo da seguinte chave do Registro:

HKEY_CURRENT_USER\Software\Microsoft\Ras Autodial\Padrão

O valor que armazena o nome da conexão é:

DefaultInternet

Esse valor é do tipo REG_SZ.

Observação

O cabeçalho ras.h define RasGetAutodialAddress 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

RASAUTODIALENTRY

RasEnumAutodialAddresses

RasSetAutodialAddress

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

Funções do serviço de acesso remoto