Freigeben über

ICredentialProvider::SetSerialization-Methode (credentialprovider.h)

  • Artikel

Legt die Serialisierungseigenschaften des Anmeldeinformationsanbieters fest.

Syntax

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

Parameter

[in] pcpcs

Typ: const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION*

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

Rückgabewert

Typ: HRESULT

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

Hinweise

Diese Methode ist erforderlich. Sie akzeptiert Anmeldeinformationen und bestimmt, ob pcpcs teil- oder vollständige Anmeldeinformationen war. Wenn es sich um teilweise Anmeldeinformationen handelt, sind sie entweder unvollständig oder wurden zum Zweck der Anzeige einiger Informationen für den Benutzer übergeben. Wenn es sich um vollständige Anmeldeinformationen handelt, sollten sie serialisiert und übermittelt werden. Verwenden Sie die Member des CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION und die in SetUsageScenario übergebenen Flags, um zu bestimmen, wie die Eingabe behandelt werden soll. Der Anmeldeinformationsanbieter ist dafür verantwortlich, die Integrität der Eingabe zu überprüfen. Die Benutzeroberfläche für Anmeldeinformationen und die Anmeldeoberfläche führen keine Überprüfungen der Struktur durch, bevor sie an den Anmeldeinformationsanbieter übergeben werden.

SetSerialization wird immer nach SetUsageScenario aufgerufen. Die Anmeldeoberfläche ruft auch SetSerialization auf, wenn ein Filter über UpdateRemoteCredential Anmeldeinformationen zurückgibt. Diese Methode wird beim erneuten Auflisten von Kacheln aufgrund eines Aufrufs von CredentialsChanged nicht verwendet. Die Benutzeroberfläche für Anmeldeinformationen ruft SetSerialization auf, wenn eine Anwendung Eingabeanmeldeinformationen bereitgestellt hat.

Die Benutzeroberfläche für Anmeldeinformationen erzwingt die folgenden Regeln basierend auf den dwFlags für diesen Inhaltsanbieter instance definiert, als SetUsageScenario aufgerufen wurde.

  • Wenn die Flags CREDUIWIN_IN_CRED_ONLY enthalten, sind alle Anmeldeinformationsanbieter aktiviert, die S_OK zurückgeben.
  • Wenn die Flags CREDUIWIN_AUTHPACKAGE_ONLY enthalten, werden alle Anmeldeinformationsanbieter aktiviert, die eine erfolgreiche status zurückgeben.
  • Wenn keines dieser Flags enthalten ist, folgt die Benutzeroberfläche für Anmeldeinformationen der gleichen Logik wie die Anmeldeschnittstelle, und alle Anmeldeinformationsanbieter, die die CREDENTIAL_PROVIDER_USAGE_SCENARIOCPUS_REDUI implementieren, werden unabhängig vom zurückgegebenen status-Wert aktiviert.
Anmeldeinformationsanbieter, die eine CREDENTIAL_PROVIDER_USAGE_SCENARIO von CPUS_LOGON implementieren und einen Fehler von dieser Methode zurückgeben, werden weiterhin aktiviert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile credentialprovider.h