Funzione RasSetCustomAuthDataA (ras.h)
Usare la funzione RasSetCustomAuthData per impostare le informazioni di autenticazione specifiche della connessione. Queste informazioni non devono essere specifiche di un determinato utente.
Sintassi
DWORD RasSetCustomAuthDataA(
[in] LPCSTR pszPhonebook,
[in] LPCSTR pszEntry,
[in] BYTE *pbCustomAuthData,
[in] DWORD dwSizeofCustomAuthData
);
Parametri
[in] pszPhonebook
Puntatore a una stringa con terminazione Null che specifica il percorso completo del file della rubrica telefonica (PBK). Se questo parametro è NULL, la funzione utilizza la rubrica di sistema.
[in] pszEntry
Puntatore a una stringa con terminazione Null che specifica un nome di voce esistente.
[in] pbCustomAuthData
Puntatore a un buffer che specifica i nuovi dati di autenticazione.
[in] dwSizeofCustomAuthData
Specifica le dimensioni dei dati a cui punta il parametro pbCustomAuthData .
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 |
---|---|
|
Il parametro dwSizeofCustomAuthData è zero oppure il parametro pbCustomAuthData è NULL. |
|
RasSetEapUserData non è riuscito ad aprire il file di rubrica specificato. |
|
RasSetEapUserData non è riuscito a trovare la voce specificata nella rubrica telefonica. |
|
Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito. |
Commenti
Nota
L'intestazione ras.h definisce RasSetCustomAuthData 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 |