ICredentialProvider::SetSerialization-Methode (credentialprovider.h)

Legt die Serialisierungsmerkmale des Anmeldeinformationsanbieters fest.

Syntax

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

Die Parameter

[in] pcpcs

Typ: const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION*

Ein Zeiger auf eine CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION Struktur, in der die Serialisierungsmerkmale des Anmeldeinformationsanbieters gespeichert werden.

Rückgabewert

Typ: HRESULT-

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Bemerkungen

Diese Methode ist erforderlich. Sie akzeptiert eine Anmeldeinformation und bestimmt, ob pcpcs teilweise oder vollständig anmeldeinformationen waren. Wenn es sich um eine Teilanmeldeinformation handelt, ist sie entweder unvollständig oder wurde zum Zwecke der Anzeige einiger Informationen an den Benutzer übergeben. Wenn es sich um eine vollständige Anmeldeinformation handelt, sollte sie serialisiert und übermittelt werden. Verwenden Sie die Member der CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION und die in SetUsageScenario übergebenen Flags, um zu bestimmen, wie die Eingabe behandelt werden soll. Die Verantwortung liegt auf dem Anmeldeinformationsanbieter, um die Integrität der Eingabe zu überprüfen. Die Benutzeroberfläche für Anmeldeinformationen und die Anmeldebenutzeroberflächen führen keine Überprüfungen der Struktur durch, bevor sie an den Anmeldeinformationsanbieter übergeben werden.

SetSerialization wird immer nach SetUsageScenario aufgerufen. Die Anmelde-UI ruft auch SetSerialization auf, wenn ein Filter eine Anmeldeinformation über UpdateRemoteCredential zurückgibt. Diese Methode wird beim erneuten Aufzählen von Kacheln aufgrund eines Aufrufs von CredentialsChanged nicht verwendet. Die Benutzeroberfläche für Anmeldeinformationen ruft SetSerialization auf, wenn eine Eingabeanmeldeinformation von einer Anwendung bereitgestellt wurde.

Die Benutzeroberfläche für Anmeldeinformationen erzwingt die folgenden Regeln basierend auf der dwFlags für diese Inhaltsanbieterinstanz, die beim Aufrufen von SetUsageScenario definiert wurde.

• Wenn die Flags CREDUIWIN_IN_CRED_ONLY enthalten, sind alle Anmeldeinformationsanbieter, die S_OK zurückgeben, aktiviert.
• Wenn die Flags CREDUIWIN_AUTHPACKAGE_ONLY enthalten, werden alle Anmeldeinformationsanbieter, die einen Erfolgsstatus zurückgeben, aktiviert.
• Wenn keine dieser Flags enthalten ist, folgt die Anmeldeinformationsbenutzeroberfläche der gleichen Logik wie die Anmeldebenutzeroberfläche und alle Anmeldeinformationsanbieter, die die CREDENTIAL_PROVIDER_USAGE_SCENARIO implementieren, CPUS_REDUI werden unabhängig vom zurückgegebenen Statuswert aktiviert.

Anforderungen