Edit

EapHostPeerGetDataToUnplumbCredentials function (eappapis.h)

Returns the Connection Id,User Impersonation Token and Eaphost Process Id used by EAPHost to save the credentials for SSO. This data is needed to unplumb previously plumbed credentials.

Important   Unplumbing of credentials (plumbed as part of the SSO experience) on disconnection is no longer performed by EAPHost. Unplumbing of credentials now needs to be performed by the supplicant.
 

Syntax

DWORD EapHostPeerGetDataToUnplumbCredentials(
  [out] GUID          *pConnectionIdThatLastSavedCreds,
  [out] __int3264     *phCredentialImpersonationToken,
  [out] EAP_SESSIONID sessionHandle,
  [in]  EAP_ERROR     **ppEapError,
  [out] BOOL          *fSaveToCredMan
);

Parameters

[out] pConnectionIdThatLastSavedCreds

The GUID of the EAP peer session that last plumbed credentials.

[out] phCredentialImpersonationToken

Handle to impersonate the user at the time of plumbing credentials. The user can be impersonated by a call to ImpersonateLoggedOnUser.

[out] sessionHandle

A pseudo handle to the EAPHost process. This is the __int3264 value returned to EAPHost when it called GetCurrentProcess.

[in] ppEapError

A pointer to an EAP_SESSIONID structure that contains the unique handle for this EAP authentication session on the EAPHost server. This handle is returned in the pSessionId parameter in a previous call to EapHostPeerBeginSession.

[out] fSaveToCredMan

A pointer to the address of an EAP_ERROR structure. The address should be set to NULL before calling this function. If error data is available, a pointer to the address of an EAP_ERROR structure that contains any errors raised during the execution of this function call is received. After using the error data, free this memory by calling EapHostPeerFreeEapError.

Return value

None

Requirements

Requirement Value
Minimum supported client Windows 10 [desktop apps only]
Minimum supported server Windows Server 2016 [desktop apps only]
Target Platform Windows
Header eappapis.h
Library Eappprxy.lib
DLL Eappprxy.dll

See also

EAPHost Supplicant Run-time Functions

EapHostPeerBeginSession

EapHostPeerEndSession