Funzione RasSetEntryDialParamsA (ras.h)

Articolo
03/13/2024

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

Sintassi

DWORD RasSetEntryDialParamsA(
  [in] LPCSTR           unnamedParam1,
  [in] LPRASDIALPARAMSA unnamedParam2,
  [in] BOOL             unnamedParam3
);

Parametri

[in] unnamedParam1

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

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

[in] unnamedParam2

Puntatore alla struttura RASDIALPARAMS che specifica i parametri di connessione da associare alla voce della rubrica telefonica. RasSetEntryDialParams usa i membri della struttura come indicato di seguito.

Membro	Significato
dwSize	Specificare le dimensioni di (RASDIALPARAMS) per identificare la versione della struttura.
szEntryName	Stringa con terminazione Null che identifica la voce della rubrica telefonica per cui impostare i parametri.
szPhoneNumber	Non usato. Impostare su NULL.
szCallbackNumber	Stringa con terminazione Null contenente il numero di telefono di callback. Se szCallbackNumber è una stringa vuota ( "", il numero di callback non viene modificato.
szUserName	Stringa con terminazione Null contenente il nome di accesso dell'utente associato a questa voce. Se szUserName è una stringa vuota, il nome utente non viene modificato.
szPassword	Stringa con terminazione Null contenente la password per l'utente specificato da szUserName. Se szUserName è una stringa vuota, la password non viene modificata. Se szPassword è una stringa vuota e fRemovePassword è FALSE, la password viene impostata sulla stringa vuota. Se fRemovePassword è TRUE, la password archiviata in questa voce della rubrica telefonica per l'utente specificato da szUserName viene rimossa indipendentemente dal contenuto della stringa szPassword . Windows NT 4.0: La password viene modificata nella stringa specificata da szPassword indipendentemente dal fatto che szUserName sia una stringa vuota. Windows XP/2000: Se szPassword contiene l'handle della password restituito da RasGetCredentials o RasGetEntryDialParams, RasSetEntryDialParams restituisce correttamente senza modificare alcuna password attualmente salvata.
szDomain	Stringa con terminazione Null che contiene il nome del dominio in cui eseguire l'accesso. Se szDomain è una stringa vuota, il nome di dominio non viene modificato.
dwSubEntry	Specifica l'indice (in base uno) della sottoentità iniziale da comporre quando si stabilisce la connessione.
dwCallbackId	Specifica un valore definito dall'applicazione che RAS passa alla funzione di callback RasDialFunc2 .

[in] unnamedParam3

Specifica se rimuovere la password archiviata della voce della rubrica telefonica per l'utente indicato da lprasdialparams-szUserName>. Se fRemovePassword è TRUE, la password viene rimossa. L'impostazione di fRemovePassword su TRUE equivale a selezionare la casella di controllo "Annulla password" in Rete remota. Quando si imposta la password o altre proprietà di una voce della rubrica telefonica, impostare fRemovePassword su FALSE.

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	Descrizione
ERROR_BUFFER_INVALID	L'indirizzo o il buffer specificato da lprasdialparams non è valido.
ERROR_CANNOT_OPEN_PHONEBOOK	La rubrica è danneggiata o mancante.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY	La voce della rubrica telefonica non esiste.

Commenti

Per creare una nuova voce della rubrica telefonica, usare la funzione RasSetEntryProperties .

Windows XP o versione successiva: Non usare la funzione RasSetEntryDialParams . Per impostare le credenziali per una voce della rubrica, usare la funzione RasSetCredentials . Impostare i membri non credenziali di RASDIALPARAMS (ad esempio szCallbackNumber, dwSubEntry o dwCallbackId) direttamente nella struttura RASDIALPARAMS passata come parametro alla funzione RasDial .

Nota

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