Funzione RasSetEapUserDataA (ras.h)

Articolo
03/01/2024

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

Condividi tramite