Token Property of the IFWXAuthenticatedWindowsUser Interface

The Token property gets the token for a Windows user.

HRESULT get_Token(
  [out]  DWORD* phToken



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

Return Value

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


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.


Server Requires Windows Server 2008.
Version Requires Forefront Threat Management Gateway (TMG).

Declared in Wspfwext.idl.


Requires Wspsrv.exe.

See Also


Send comments about this topic to Microsoft

Build date: 11/30/2009

© 2008 Microsoft Corporation. All rights reserved.