Funzione RasSetCustomAuthDataA (ras.h)

  • Articolo

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
E_INVALIDARG
 Il parametro dwSizeofCustomAuthData è zero oppure il parametro pbCustomAuthData è NULL.
ERROR_CANNOT_OPEN_PHONEBOOK

RasSetEapUserData non è riuscito ad aprire il file di rubrica specificato.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY

RasSetEapUserData non è riuscito a trovare la voce specificata nella rubrica telefonica.
Altri
 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

Vedi anche

RasGetCustomAuthData

RasSetEapUserData