Funzione RasSetEapUserDataA (ras.h)

  • Articolo

Usare la funzione RasSetEapUserData per archiviare le informazioni di Extensible Authentication Protocol (EAP) specifiche dell'utente per la voce della rubrica telefonica specificata nel Registro di sistema.

Sintassi

DWORD RasSetEapUserDataA(
  [in] HANDLE hToken,
  [in] LPCSTR pszPhonebook,
  [in] LPCSTR pszEntry,
  [in] BYTE   *pbEapData,
  [in] DWORD  dwSizeofEapData
);

Parametri

[in] hToken

Gestire un token di accesso primario o di rappresentazione che rappresenta l'utente per cui archiviare i dati. Questo parametro può essere NULL se la funzione viene chiamata da un processo già in esecuzione nel contesto dell'utente.

[in] pszPhonebook

Puntatore a una stringa con terminazione null che specifica il percorso completo del file PBK (phone-book). Se questo parametro è NULL, la funzione usa la rubrica telefonica del sistema.

[in] pszEntry

Puntatore a una stringa con terminazione null che specifica un nome di voce esistente.

[in] pbEapData

Puntatore ai dati da archiviare per l'utente.

[in] dwSizeofEapData

Specifica le dimensioni dei dati a cui punta il parametro pbEapData .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti o un valore da Routing e codici di errore di accesso remoto o Winerror.h.

Valore Significato
E_INVALIDARG
 Il parametro dwSizeofEapData è zero o il parametro pbEapData è NULL.
ERROR_CANNOT_OPEN_PHONEBOOK
 RasSetEapUserData non è stato in grado di aprire il file di rubrica telefonico 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 RasSetEapUserData come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

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

RasGetEapUserData

RasInvokeEapUI

Panoramica del servizio di accesso remoto (RAS)

Funzioni del Servizio di accesso remoto