Funzione RasSetAutodialAddressA (ras.h)

La funzione rasSetAutodialAddress può aggiungere un indirizzo al database di mapping AutoDial. In alternativa, la funzione può eliminare o modificare i dati associati a un indirizzo esistente nel database.

Sintassi

DWORD RasSetAutodialAddressA(
  [in] LPCSTR              unnamedParam1,
  [in] DWORD               unnamedParam2,
  [in] LPRASAUTODIALENTRYA unnamedParam3,
  [in] DWORD               unnamedParam4,
  [in] DWORD               unnamedParam5
);

Parametri

[in] unnamedParam1

Puntatore a un nullstringa con terminazione che specifica l'indirizzo da aggiungere, eliminare o modificare. Questo indirizzo può essere un indirizzo IP, un nome host Internet ("www.microsoft.com") o un nome NetBIOS ("products1").

Se questo parametro è NULL, la funzione imposta la connessione Internet predefinita (vedere Osservazioni). Se questo parametro punta a una stringa di lunghezza zero, la funzione elimina la connessione Internet predefinita.

[in] unnamedParam2

Riservato; deve essere zero.

[in] unnamedParam3

Puntatore a una matrice di una o più strutture RASAUTODIALENTRY da associare all'indirizzo lpszAddress . Se lpAutoDialEntries è NULL e dwcbAutoDialEntries è zero, RasSetAutodialAddress elimina tutte le strutture associate a lpszAddress dal database di mapping.

[in] unnamedParam4

Specifica le dimensioni, in byte, delle lpAutoDialEntries buffer.

[in] unnamedParam5

Specifica il numero di strutture di RASAUTODIALENTRY nel buffer lpAutoDialE ntries.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti o un valore di Codici di errore di routing e accesso remoto o Winerror.h.

Valore	Significato
ERROR_INVALID_SIZE	Il membro dwSize della struttura RASAUTODIALENTRY è un valore non valido.
ERROR_INVALID_PARAMETER	Il parametro lpszAddress è NULL.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	Il nome della connessione specificato in lpAutoDialEntries non esiste.

Osservazioni

Un indirizzo nel database di mapping AutoDial può avere un numero qualsiasi di voci RASAUTODIALENTRY. Ogni voce specifica le informazioni di autodial per una determinata posizione di composizione TAPI.

Se l'indirizzo specificato dal parametro lpszAddress è un indirizzo esistente nel database e il parametro lpAutoDialEntries non è NULL, la funzione RasSetAutodialAddress modifica il set di voci AutoDial associate all'indirizzo. Se una voce nella lpAutoDialEntries matrice specifica una posizione di composizione per cui l'indirizzo ha già una voce, la funzione sostituisce la voce esistente con la nuova voce. In caso contrario, la funzione aggiunge semplicemente il lpAutoDialEntries voci al set di voci per l'indirizzo.

Se nel database è presente l'indirizzo lpszAddress , lpAutoDialEntries è NULLe lpAutoDialEntries è zero, RasSetAutodialAddress elimina l'indirizzo dal database.

Se l'indirizzo lpszAddress non esiste nel database, RasSetAutodialAddress aggiunge l'indirizzo al database. Il parametro lpAutoDialEntries specifica le voci AutoDial da associare al nuovo indirizzo.

RAS supporta una connessione Internet predefinita globale al computer locale e supporta una connessione Internet predefinita per ogni utente.

Quando il parametro lpszAddress è NULLe il parametro lpAutoDialEntries specifica un nome di connessione con una voce, RasSetAutodialAddress imposta la connessione come connessione Internet predefinita. Il nome della connessione specificato in lpAutoDialEntries dovrebbe esistere già. In caso contrario, verrà restituito ERROR_CANNOT_FIND_PHONEBOOK_ENTRY.

Quando il parametro lpszAddress è una stringa di lunghezza zero e il parametro lpAutoDialEntries specifica un nome di connessione vuoto con una voce, RasSetAutodialAddress elimina la connessione Internet predefinita.

Nei computer client non di dominio, se un utente desidera impostare una connessione come connessione Internet predefinita e specifica una connessione "for-all-users" nel szEntry membro della struttura RASAUTODIALENTRY, la connessione Internet predefinita viene impostata a livello globale nel computer locale. In tutti gli altri casi la connessione Internet predefinita viene impostata singolarmente per ogni utente del computer.

È possibile avere due connessioni con lo stesso nome se una è configurata come connessione "for-all-users" e l'altra è configurata come connessione "solo per me". Se il parametro lpAutoDialEntries specifica un nome di connessione che corrisponde a una connessione globale e a una connessione per utente, viene impostata la connessione per utente.

Nota

L'intestazione ras.h definisce RasSetAutodialAddress 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	ras.h
libreria	Rasapi32.lib
dll	Rasapi32.dll

Vedere anche

RASAUTODIALENTRY

RasEnumAutodialAddresses

RasGetAutodialAddress

Panoramica servizio di accesso remoto (RAS)

funzioni del servizio accesso remoto