IUpdateEndpointAuthProvider::GetPreferredEndpointTokenType method

Returns the preferred type of authentication token for the endpoint of the service.

Syntax

HRESULT GetPreferredEndpointTokenType(
  [in]  GUID               serviceId,
  [in]  UpdateEndpointType endpointType,
  [in]  ULONG              ulRequestedTypes,
  [out] ULONG              *pulPreferredTokenTypes
);

Parameters

serviceId [in]

Identifies the service to be updated.

endpointType [in]

Identifies the type of endpoint needed to connect to the service.

ulRequestedTypes [in]

Identifies the ORed set of tokens that are supported by the endpoint.

pulPreferredTokenTypes [out]

Specify the ORed set of authentication token types that are preferred. (Set to 0 to indicate that no authentication token is needed).

Return value

Returns S_OK if successful. Otherwise, returns a COM or Windows error code.

Remarks

When this method is returned, WUA chooses a token type from the preferred types and passes it to the tokenType parameter of the GetEndpointToken method.

Requirements

Requirement Value
Minimum supported client
Windows XP, Windows 2000 Professional with SP3 [desktop apps only]
Minimum supported server
Windows Server 2003, Windows 2000 Server with SP3 [desktop apps only]
Header
UpdateEndpointAuth.h
IDL
UpdateEndpointAuth.idl
Library
UpdateEndpointAuth.lib
DLL
UpdateEndpointAuth.dll

See also

IUpdateEndpointAuthProvider

GetEndpointToken