Funzione RasGetAutodialParamA (ras.h)

  • Articolo

La funzione RasGetAutodialParam recupera il valore di un parametro AutoDial.

Sintassi

DWORD RasGetAutodialParamA(
  [in]      DWORD   unnamedParam1,
  [out]     LPVOID  unnamedParam2,
  [in, out] LPDWORD unnamedParam3
);

Parametri

[in] unnamedParam1

Specifica il parametro AutoDial da recuperare. Questo parametro può avere uno dei valori seguenti.

Valore Significato
RASADP_DisableConnectionQuery
 Il parametro lpvValue restituisce un valore DWORD . Se questo valore è zero (impostazione predefinita), AutoDial visualizza una finestra di dialogo per eseguire una query sull'utente prima di creare una connessione. Se questo valore è 1 e il database AutoDial ha la voce della rubrica telefonica da comporre, AutoDial crea una connessione senza visualizzare la finestra di dialogo.
RASADP_LoginSessionDisable
 Il parametro lpvValue restituisce un valore DWORD . Se questo valore è 1, il sistema disabilita tutte le connessioni AutoDial per la sessione di accesso corrente. Se questo valore è zero (impostazione predefinita), le connessioni AutoDial sono abilitate. Il servizio di sistema AutoDial imposta questo valore su zero quando un nuovo utente accede alla workstation.
RASADP_SavedAddressesLimit
 Il parametro lpvValue restituisce un valore DWORD che indica il numero massimo di indirizzi archiviati da AutoDial nel Registro di sistema. AutoDial archivia prima gli indirizzi usati per creare una connessione AutoDial; archivia quindi gli indirizzi appresi dopo la creazione di una connessione RAS. Gli indirizzi scritti usando la funzione RasSetAutodialAddress vengono sempre salvati e non sono inclusi nel calcolo del limite. Il valore predefinito è 100.
RASADP_FailedConnectionTimeout
 Il parametro lpvValue restituisce un valore DWORD che indica un valore di timeout, espresso in secondi. Quando un tentativo di connessione AutoDial non riesce, il servizio di sistema AutoDial disabilita i tentativi successivi di raggiungere lo stesso indirizzo per il periodo di timeout. Ciò impedisce a AutoDial di visualizzare più finestre di dialogo di connessione per la stessa richiesta logica da parte di un'applicazione. Il valore predefinito è 5.
RASADP_ConnectionQueryTimeout
 Il parametro lpvValue punta a un valore DWORD che indica un valore di timeout, espresso in secondi. Prima di tentare una connessione AutoDial, il sistema visualizzerà una finestra di dialogo che chiede all'utente di confermare che il sistema deve comporre. La finestra di dialogo ha un timer di conto alla rovescia che termina la finestra di dialogo con una selezione "Non comporre" se l'utente non esegue alcuna azione. Il valore DWORD a cui punta lpvValue specifica l'ora iniziale per questo timer di conto alla rovescia.

[out] unnamedParam2

Puntatore a un buffer che riceve il valore per il parametro specificato.

[in, out] unnamedParam3

Puntatore a un valore DWORD .

In input, impostare questo valore per indicare le dimensioni, in byte, del buffer lpvValue .

Nell'output questo valore indica le dimensioni effettive del valore scritto nel buffer.

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
ERROR_INVALID_PARAMETER
 Il parametro dwKey o lpvValue non è valido.
ERROR_INVALID_SIZE
 La dimensione specificata da lpdwcbValue è troppo piccola.

Commenti

Nota

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

Vedi anche

RasSetAutodialAddress

RasSetAutodialParam

Panoramica del servizio accesso remoto (RAS)

Funzioni del Servizio di accesso remoto