Funzione RasGetAutodialAddressA (ras.h)

La funzione RasGetAutodialAddress recupera informazioni su tutte le voci AutoDial associate a un indirizzo di rete nel database di mapping AutoDial.

Sintassi

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

Parametri

[in] unnamedParam1

Puntatore a una stringa con terminazione Null che specifica l'indirizzo per cui vengono richieste le informazioni. Può trattarsi di un indirizzo IP, un nome host Internet ("www.microsoft.com") o un nome NetBIOS ("products1").

Se questo parametro è NULL, la funzione recupera la connessione Internet predefinita. La funzione restituisce la connessione Internet predefinita per utente, se configurata. In caso contrario, la funzione restituisce la connessione Internet predefinita globale. Se non sono configurate connessioni Internet predefinite, la funzione restituisce zero per i parametri lpdwcbAutoDialEntries e lpdwcAutoDialEntries .

[in] unnamedParam2

Riservati; deve essere NULL.

[in, out] unnamedParam3

Puntatore a un buffer che, nell'output, riceve una matrice di strutture RASAUTODIALENTRY , una per ogni voce AutoDial associata all'indirizzo specificato dal parametro lpszAddress .

In base all'input, impostare il membro dwSize della prima struttura RASAUTODIALENTRY nel buffer su sizeof(RASAUTODIALENTRY) per identificare la versione della struttura.

Se lpAutoDialEntries è NULL, RasGetAutodialAddress imposta i parametri lpdwcbAutoDialEntries e lpdwcAutoDialEntries per indicare le dimensioni del buffer necessarie, in byte e il numero di voci AutoDial.

[in, out] unnamedParam4

Puntatore a una variabile che, in input, specifica le dimensioni, in byte, del buffer lpAutoDialEntries .

Nell'output, questa variabile riceve il numero di byte restituiti o il numero di byte necessari se il buffer è troppo piccolo.

[out] unnamedParam5

Puntatore a una variabile che riceve il numero di elementi della struttura restituiti nel buffer lpAutoDialEntries .

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti o un valore di Routing e Remote Access Error Codes o Winerror.h.

Valore	Significato
ERROR_INVALID_SIZE	Il membro dwSize della struttura RASAUTODIALENTRY è un valore non valido.
ERROR_INVALID_PARAMETER	Il parametro lpszAddress, lpdwcbAutoDialEntries o lpdwcAutoDialEntries è NULL.

Commenti

Il servizio di accesso remoto (RAS) supporta le connessioni Internet predefinite. RAS supporta una connessione Internet predefinita globale al computer locale e supporta inoltre una connessione Internet predefinita per ogni utente.

Il nome della connessione Internet predefinita globale viene archiviato nel Registro di sistema sotto la seguente chiave del Registro di sistema:

HKEY_LOCAL_MACHINE
   Software
      Microsoft
         Ras Autodial
            Default

Il valore che archivia il nome della connessione è:

DefaultInternet

Questo valore è di tipo REG_SZ.

La connessione Internet predefinita globale deve essere configurata come connessione Per tutti gli utenti nell'interfaccia utente della cartella Connections.

Il nome della connessione Internet predefinita per utente viene archiviato nel Registro di sistema sotto la seguente chiave del Registro di sistema:

HKEY_CURRENT_USER\Software\Microsoft\Ras Autodial\Predefinito

Il valore che archivia il nome della connessione è:

DefaultInternet

Questo valore è di tipo REG_SZ.

Nota

L'intestazione ras.h definisce RasGetAutodialAddress come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ras.h
Libreria	Rasapi32.lib
DLL	Rasapi32.dll

Vedi anche

RASAUTODIALENTRY

RasEnumAutodialAddresses

RasSetAutodialAddress

Panoramica del servizio accesso remoto (RAS)

Funzioni del Servizio di accesso remoto