Edit

ICredentialProvider::SetSerialization method (credentialprovider.h)

  • Article

Sets the serialization characteristics of the credential provider.

Syntax

HRESULT SetSerialization(
  [in] const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION *pcpcs
);

Parameters

[in] pcpcs

Type: const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION*

A pointer to a CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION structure that stores the serialization characteristics of the credential provider.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

This method is required. It accepts a credential and determines if pcpcs was a partial or a full credential. If it is a partial credential, it is either incomplete or was passed for the purpose of displaying some information to the user. If it is a full credential, it should be serialized and submitted. Use the members of the CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION and the flags passed in SetUsageScenario to determine how to handle the input. The responsibility is on the credential provider to verify the integrity of the input. The Credential UI and Logon UI do not perform any checks on the structure before passing it to the credential provider.

SetSerialization is always called after SetUsageScenario. The Logon UI also calls SetSerialization when a filter returns a credential through UpdateRemoteCredential. It does not use this method when re-enumerating tiles because of a call to CredentialsChanged. The Credential UI calls SetSerialization when an input credential has been suppled by an application.

The Credential UI enforces the following rules based on the dwFlags for this content provider instance defined when SetUsageScenario was called.

  • If the flags include CREDUIWIN_IN_CRED_ONLY, all credential providers returning S_OK are enabled.
  • If the flags include CREDUIWIN_AUTHPACKAGE_ONLY, all credential providers returning a success status are enabled.
  • If neither of those flags are included, then the Credential UI follows the same logic as the Logon UI and all credential providers that implement the CREDENTIAL_PROVIDER_USAGE_SCENARIOCPUS_REDUI will be enabled regardless of the returned status value.
Credential providers that implement a CREDENTIAL_PROVIDER_USAGE_SCENARIO of CPUS_LOGON and return a failure from this method will still be enabled.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header credentialprovider.h