Funzione RasSetAutodialAddressA (ras.h)
La funzione RasSetAutodialAddress può aggiungere un indirizzo al database di mapping automatico. 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 una stringa con terminazione null che specifica l'indirizzo da aggiungere, eliminare o modificare. Questo indirizzo può essere un indirizzo IP, nome host Internet ("www.microsoft.com") o 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
Riservati; 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, del buffer lpAutoDialEntries .
[in] unnamedParam5
Specifica il numero di strutture RASAUTODIALENTRY nel buffer lpAutoDialEntries .
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 da Routing e codici di errore di accesso remoto o Winerror.h.
Valore | Significato |
---|---|
|
Il membro dwSize della struttura RASAUTODIALENTRY è un valore non valido. |
|
Il parametro lpszAddress è NULL. |
|
Il nome di connessione specificato in lpAutoDialEntries non esiste. |
Commenti
Un indirizzo nel database di mapping automatico può avere un numero qualsiasi di voci RASAUTODIALENTRY associate. Ogni voce specifica le informazioni autodiali 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 autodiali associate all'indirizzo. Se una voce nella matrice lpAutoDialEntries 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 le voci lpAutoDialEntries al set di voci per l'indirizzo.
Se lpszAddress address esiste nel database, lpAutoDialEntries è NULL e 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 è NULL e il parametro lpAutoDialEntries specifica un nome di connessione con una voce, RasSetAutodialAddress imposta la connessione come connessione Internet predefinita. Il nome di connessione specificato in lpAutoDialEntries deve già esistere. 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 vuole impostare una connessione come connessione Internet predefinita e specifica una connessione "per tutti gli utenti" nel membro szEntry della struttura RASAUTODIALENTRY , la connessione Internet predefinita viene impostata a livello globale nel computer locale. In tutti gli altri casi la connessione Internet predefinita è impostata per ogni utente del computer singolarmente.
È 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
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 |