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 |
|---|---|
|
Il membro dwSize della struttura RASAUTODIALENTRY è un valore non valido. |
|
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 |