IFWXAuthenticatedWindowsUser::Token property

Article
08/27/2012

Applies to: desktop apps only

The Token property gets the token for a Windows user.

This property is read-only.

Syntax

HRESULT get_Token(
  [out]  DWORD *phToken
);

Property value

Pointer to a variable that on return receives a handle to a duplicate token.

Error codes

This property method should return S_OK if the call is successful; otherwise, it should return an error code.

Remarks

The Token property retrieves a handle to a duplicate token. Your implementation of the Token property must call DuplicateToken before the function returns. When you invoke the Token property, you must call CloseHandle on the token that you received.

Your implementation of IFWXAuthenticatedWindowsUser may return E_NOTIMPL for either the SID or Token property, but not both. It is not a requirement to support both properties, but one of the properties must have a meaningful implementation.

Requirements

Minimum supported client	None supported
Minimum supported server	Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)
Version	Forefront Threat Management Gateway (TMG) 2010
Header	Wspfwext.idl
DLL	Wspsrv.exe

Share via