IAzClientContext::get_UserCanonical method (azroles.h)
The UserCanonical property retrieves the name of the current client in canonical format.
This property is read-only.
Syntax
HRESULT get_UserCanonical(
BSTR *pbstrProp
);
Parameters
pbstrProp
Return value
None
Remarks
The canonical client name is retrieved by impersonating the client token and calling the GetUserNameEx function with NameCanonical specified for the NameFormat parameter.
An example of a client name in canonical format is "example.fourthcoffee.com/software/Ben Smith".
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows Vista [desktop apps only] |
Minimum supported server | Windows Server 2003 [desktop apps only] |
Target Platform | Windows |
Header | azroles.h |
Library | Azroles.lib |
DLL | Azroles.dll |
Redistributable | Windows Server 2003 Administration Tools Pack on Windows XP |