Funzione RasSetEntryDialParamsA (ras.h)
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 |
---|---|
|
Specificare le dimensioni di (RASDIALPARAMS) per identificare la versione della struttura. |
|
Stringa con terminazione Null che identifica la voce della rubrica telefonica per cui impostare i parametri. |
|
Non usato. Impostare su NULL. |
|
Stringa con terminazione Null contenente il numero di telefono di callback. Se szCallbackNumber è una stringa vuota ( "", il numero di callback non viene modificato. |
|
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. |
|
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. |
|
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. |
|
Specifica l'indice (in base uno) della sottoentità iniziale da comporre quando si stabilisce la connessione. |
|
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 |
---|---|
|
L'indirizzo o il buffer specificato da lprasdialparams non è valido. |
|
La rubrica è danneggiata o mancante. |
|
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 |