Share via


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 tneeded 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

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