ICredentialProvider::GetCredentialCount-Methode (credentialprovider.h)

Artikel
08/22/2023

Ruft die Anzahl der verfügbaren Anmeldeinformationen unter diesem Anmeldeinformationsanbieter ab.

Syntax

HRESULT GetCredentialCount(
  [out] DWORD *pdwCount,
  [out] DWORD *pdwDefault,
  [out] BOOL  *pbAutoLogonWithDefault
);

Parameter

[out] pdwCount

Typ: DWORD*

Ein Zeiger auf einen DWORD-Wert , der die Anzahl der Anmeldeinformationen empfängt.

[out] pdwDefault

Typ: DWORD*

Ein Zeiger auf einen DWORD-Wert , der den Index der Anmeldeinformationen empfängt, die als Standard verwendet werden sollen. Wenn kein Standardwert festgelegt wurde, sollte dieser Wert auf CREDENTIAL_PROVIDER_NO_DEFAULT festgelegt werden.

[out] pbAutoLogonWithDefault

Typ: BOOL*

Ein Zeiger auf einen BOOL-Wert , der angibt, ob die von pdwDefault identifizierten Standardanmeldeinformationen für einen automatischen Anmeldeversuch verwendet werden sollen. Ein automatischer Anmeldeversuch bedeutet, dass die Anmeldebenutzeroberfläche oder die Anmeldeinformationsbenutzeroberfläche sofort GetSerialization auf der Standardkachel des Anbieters aufruft.

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.

Wenn eine Anmelde- oder Anmeldeinformationsoberfläche für die Benutzerinteraktion bereit ist, wird standardmäßig eine Standardanmeldeinformation ausgewählt. Da jeder Anmeldeinformationsanbieter Standardanmeldeinformationen bereitstellt, bestimmen die folgenden Regeln, ob pdwDefault den Fokus erhält oder ob die Anmeldeinformationen automatisch angemeldet werden.

Wenn bereits Standardanmeldeinformationen angegeben wurden, diese Anmeldeinformationen nicht für die automatische Anmeldung verwendet werden sollen und pdwDefault für die automatische Anmeldung verwendet wird, wird pdwDefault als Standard verwendet.
Wenn pdwDefault vom zuletzt angemeldeten Anbieter stammt und noch keine Standardeinstellung mit automatischer Anmeldung vorhanden ist, wird pdwDefault als Standard verwendet.
Wenn kein Standardwert angegeben wurde, wird pdwDefault als Standard verwendet.

Wenn sich die Anzahl der gültigen Anmeldeinformationen ändert, sollte der Anmeldeinformationsanbieter credentialsChanged für die in Advise bereitgestellte instance ICredentialProviderEvents aufrufen.

Bewährte Methoden für Anmeldeinformationsanbieter

Anmeldeinformationsanbieter verarbeiten äußerst vertrauliche Benutzergeheimnisse, um Anmelde- und Entsperranforderungen abzuschließen. Als bewährte Methode sollten geheime Informationen wie Kennwörter und PINs mit größter Sorgfalt behandelt werden. Die geeigneten Verfahren für die Verarbeitung von Geheimnisinformationen innerhalb eines Anmeldeinformationsanbieters sind:

Verwerfen Sie Geheimnisse immer sicher. Rufen Sie dazu SecureZeroMemory auf, bevor Sie den Speicher freigeben, der zum Speichern eines Geheimnisses verwendet wird.
Verwerfen Sie Geheimnisse sicher, sobald sie verwendet werden.
Verwerfen Sie Geheimnisse sicher, wenn sie nicht innerhalb einer erwarteten Zeitspanne für den vorgesehenen Zweck verwendet werden.

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

Freigeben über