Funzione RasGetEapUserIdentityA (ras.h)

Articolo
11/20/2024

La funzione RasGetEapUserIdentity recupera le informazioni sull'identità per l'utente corrente. Usare queste informazioni per chiamare RasDial con una voce di rubrica telefonica che richiede Extensible Authentication Protocol (EAP).

Sintassi

DWORD RasGetEapUserIdentityA(
  [in]  LPCSTR                pszPhonebook,
  [in]  LPCSTR                pszEntry,
  [in]  DWORD                 dwFlags,
  [in]  HWND                  hwnd,
  [out] LPRASEAPUSERIDENTITYA *ppRasEapUserIdentity
);

Parametri

[in] pszPhonebook

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

[in] pszEntry

Puntatore a un nullstringa con terminazione che specifica un nome di voce esistente.

[in] dwFlags

Specifica zero o più flag seguenti che qualificano il processo di autenticazione.

Bandiera	Significato
RASEAPF_NonInteractive	Specifica che il protocollo di autenticazione non deve visualizzare un'interfaccia utente grafica. Se questo flag non è presente, è possibile che il protocollo visualizzi un'interfaccia utente.
RASEAPF_Logon	Specifica che i dati utente vengono ottenuti da WinLogon.
RASEAPF_Preview	Specifica che all'utente devono essere richieste informazioni sull'identità prima della composizione.

[in] hwnd

Handle nella finestra padre per la finestra di dialogo dell'interfaccia utente. Se il parametro fInvokeUI è FALSE, hwnd deve essere NULL.

[out] ppRasEapUserIdentity

Puntatore a un puntatore che, in caso di esito positivo, riceve l'indirizzo della struttura RASEAPUSERIDENTITY che contiene informazioni sull'identità utente EAP. RasGetEapUserIdentity alloca il buffer di memoria per la struttura RASEAPUSERIDENTITY . Liberare questa memoria chiamando RasFreeEapUserIdentity.

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 di Codici di errore di routing e accesso remoto o Winerror.h.

Valore	Significato
E_INVALID_ARG	Il parametro pcbEapUserIdentity è NULL.
ERROR_INTERACTIVE_MODE	La funzione è stata chiamata con il flag RASEAPF_NonInteractive. Tuttavia, il protocollo di autenticazione deve visualizzare un'interfaccia utente per ottenere le informazioni di identità necessarie dall'utente.
ERROR_INVALID_FUNCTION_FOR_ENTRY	Il metodo di autenticazione per questa voce della rubrica telefonica non è EAP o il metodo di autenticazione è EAP, ma il protocollo usa la finestra di dialogo standard delle credenziali di Windows NT/Windows 2000 per ottenere informazioni sull'identità utente. In entrambi i casi, il chiamante non deve passare le informazioni sull'identità EAP a RasDial.
ERROR_RASMAN_CANNOT_INITIALIZE	Impossibile inizializzare correttamente il servizio accesso remoto.
Altro	Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito.

Osservazioni

RasGetEapUserIdentity chiama la funzione RAS RasGetEapUserData e la funzione EAP RasEapGetIdentity. RasEapGetIdentity viene implementato dal protocollo di autenticazione.

Se la funzione ha esito positivo, ovvero il valore restituito è NO_ERROR, il chiamante deve copiare le informazioni sull'identità EAP dalla struttura RASEAPUSERIDENTITY a cui punta il parametro ppRasEapUserIdentity nel RASDIALPARAMS e strutture RASDIALEXTENSIONS utilizzate nella chiamata a RasDial.

Se l'applicazione di accesso remoto in fase di sviluppo ha un'interfaccia utente grafica, il chiamante di RasGetEapUserIdentity non deve specificare il flag di RASEAPF_NonInteractive. Se l'applicazione dispone di un'interfaccia utente della riga di comando, il chiamante può voler specificare il flag RASEAPF_NonInteractive per impedire al protocollo di autenticazione di visualizzare un'interfaccia utente grafica.

Nota

L'intestazione ras.h definisce RasGetEapUserIdentity 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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	ras.h
libreria	Rasapi32.lib
dll	Rasapi32.dll