Funzione RasGetEapUserDataA (ras.h)

  • Articolo

Usare la funzione RasGetEapUserData per recuperare le informazioni di Extensible Authentication Protocol (EAP) specifiche dell'utente per la voce della rubrica telefonica specificata.

Sintassi

DWORD RasGetEapUserDataA(
  [in]      HANDLE hToken,
  [in]      LPCSTR pszPhonebook,
  [in]      LPCSTR pszEntry,
  [out]     BYTE   *pbEapData,
  [in, out] DWORD  *pdwSizeofEapData
);

Parametri

[in] hToken

Gestire un token di accesso primario o di rappresentazione che rappresenta l'utente per cui recuperare 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.

[out] pbEapData

Puntatore a un buffer che riceve i dati EAP recuperati per l'utente. Il chiamante deve allocare la memoria per questo buffer. Se il buffer non è sufficiente, RasGetEapUserData restituisce ERROR_BUFFER_TOO_SMALL e il parametro pdwSizeofEapData contiene le dimensioni necessarie.

[in, out] pdwSizeofEapData

Puntatore a una variabile DWORD che, in input, specifica le dimensioni del buffer a cui punta il parametro pbEapData .

Se il buffer specificato dal parametro pbEapData non è sufficiente, pdwSizeofEapData riceve, in output, le dimensioni necessarie.

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 pdwSizeofEapData è NULL.
ERROR_BUFFER_TOO_SMALL
 Il buffer a cui punta pbEapData è troppo piccolo per ricevere i dati. PdwSizeofEapData contiene le dimensioni necessarie.
ERROR_CANNOT_OPEN_PHONEBOOK

RasGetEapUserData non è stato in grado di aprire il file di rubrica telefonico specificato.
ERROR_CANNOT_FIND_PHONEBOOK_ENTRY

RasGetEapUserData 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 RasGetEapUserData 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

RASEAPINFO

RasSetEapUserData

Panoramica del servizio di accesso remoto (RAS)

Funzioni del Servizio di accesso remoto