Função RasGetAutodialAddressA (ras.h)

Artigo
11/20/2024

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 um cadeia de caracteresterminada nula 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

Reservado; deve ser NULL.

[in, out] unnamedParam3

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

Na entrada, defina o dwSize membro 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 lpdwcAutoDialEnt ries para indicar o tamanho do buffer necessário, em bytes e o número de entradas do 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.

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

Observações

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 com 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 um Para todos os usuários conexão na interface do usuário pasta de conexões do .

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\Default

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

DefaultInternet

Esse valor é do tipo REG_SZ.

Nota

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 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

RASAUTODIALENTRY

RasEnumAutodialAddresses

RasSetAutodialAddress

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

Funções do Serviço de Acesso Remoto

Compartilhar via