Funzione RasGetEntryDialParamsA (ras.h)

Articolo
11/20/2024

La funzione RasGetEntryDialPara ms recupera le informazioni di connessione salvate dall'ultima chiamata riuscita al RasDial o funzione 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 un nullstringa con terminazione che specifica il percorso completo e il nome file di un file con rubrica telefonica (PBK). Se questo parametro è NULL, la funzione usa il file predefinito corrente della rubrica telefonica. Il file predefinito della rubrica telefonica è quello selezionato dall'utente nella finestra di dialogo Preferenze utente della finestra di dialogo Rete remota.

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

[in, out] unnamedParam2

Puntatore a una struttura RASDIALPARAMS.

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

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

Si noti che il szPhoneNumber membro 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. Al contrario, szPassword contiene un handle per la password salvata. Sostituire questo handle per la password salvata nelle chiamate successive a RasSetEntryDialParams e RasDial. Quando viene visualizzato 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 per questa voce non è stata salvata alcuna password, 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 punta a 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 di Codici di errore di routing e accesso remoto o Winerror.h.

Valore	Descrizione
ERROR_BUFFER_INVALID	Il puntatore lprasdialparams o lpfPassword non è valido oppure l'lprasdialparams buffer non è valido.
ERROR_CANNOT_OPEN_PHONEBOOK	La rubrica telefonica è danneggiata o mancano componenti.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	La voce della rubrica telefonica non esiste.

Osservazioni

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 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