Token Property of the IFWXAuthenticatedWindowsUser Interface

The Token property gets the token for a Windows user.

HRESULT get_Token(
  [out]  DWORD* phToken
);

Parameters

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.

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

Server	Requires Windows Server 2008.
Version	Requires Forefront Threat Management Gateway (TMG).
Header	Declared in Wspfwext.idl.
DLL	Requires Wspsrv.exe.

See Also

IFWXAuthenticatedWindowsUser

Send comments about this topic to Microsoft

Build date: 11/30/2009