Funzione RasGetEntryDialParamsA (ras.h)

Articolo
03/15/2023

La funzione RasGetEntryDialParams recupera le informazioni di connessione salvate dall'ultima chiamata alla funzione RasDial o RasSetEntryDialParams per una voce di rubrica telefonica specificata.

Sintassi

DWORD RasGetEntryDialParamsA(
  [in]      LPCSTR           unnamedParam1,
  [in, out] LPRASDIALPARAMSA unnamedParam2,
  [out]     LPBOOL           unnamedParam3
);

Parametri

[in] unnamedParam1

Puntatore a una stringa con terminazione null che specifica il percorso completo e il nome file di un file PBK (Phone Book). Se questo parametro è NULL, la funzione usa il file di rubrica telefonico predefinito corrente. Il file di rubrica telefonico predefinito è quello selezionato dall'utente nella finestra di proprietà Preferenze utente della finestra di dialogo Rete remota .

Windows Me/98/95: Questo parametro deve sempre essere NULL. La rete con accesso esterno archivia le voci della rubrica telefonica nel Registro di sistema anziché in un file di rubrica telefonica.

[in, out] unnamedParam2

Puntatore a una struttura RASDIALPARAMS .

In input, il membro dwSize specifica le dimensioni della struttura RASDIALPARAMS e il membro szEntryName specifica una voce di rubrica telefonica valida.

In output, la struttura riceve i parametri di connessione associati alla voce della rubrica telefonica specificata.

Si noti che il membro szPhoneNumber della struttura non riceve il numero di telefono associato alla voce della rubrica telefonica. Per ottenere il numero di telefono associato a una voce di rubrica telefonica, chiamare la funzione RasGetEntryProperties . Se szPhoneNumber è una stringa vuota nella struttura RASDIALPARAMS passata a RasDial, RasDial usa il numero di telefono archiviato nella voce della rubrica telefonica.

Il membro szPassword della struttura RASDIALPARAMS non restituisce la password effettiva. SzPassword contiene invece un handle per la password salvata. Sostituire questo handle per la password salvata nelle chiamate successive a RasSetEntryDialParams e RasDial. Quando viene presentato con questo handle, RasDial recupera e usa la password salvata. Il valore di questo handle può cambiare nelle versioni future del sistema operativo; non sviluppare codice che dipende dal contenuto o dal formato di questo valore.

Windows NT e Windows Me/98/95: Funzionalità password sicura non supportata.

[out] unnamedParam3

Puntatore a un flag che indica se la funzione ha recuperato la password associata al nome utente per la voce della rubrica telefonica. Il parametro lpfPassword è TRUE se il sistema ha salvato una password per la voce specificata. Se il sistema non ha alcuna password salvata per questa voce, lpfPassword è FALSE.

Windows NT e Windows Me/98/95: La funzione imposta questo flag su TRUE se la password dell'utente è stata restituita nel membro szPassword della struttura RASDIALPARAMS a cui punta lprasdialparams.

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	Descrizione
ERROR_BUFFER_INVALID	Il puntatore lprasdialparams o lpfPassword non è valido oppure il buffer lprasdialparams non è valido.
ERROR_CANNOT_OPEN_PHONEBOOK	Il telefono è danneggiato o mancante componenti.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	La voce della rubrica telefonica non esiste.

Commenti

Nota

L'intestazione ras.h definisce RasGetEntryDialParams 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


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