ICredentialProviderCredential::SetStringValue-Methode (credentialprovider.h)

  • Artikel

Ermöglicht einer Anmelde-UI oder Anmeldeinformations-Benutzeroberfläche, den Text für eine CPFT_EDIT_TEXT Felder zu aktualisieren, während der Benutzer sie eingibt.

Syntax

HRESULT SetStringValue(
  [in] DWORD   dwFieldID,
  [in] LPCWSTR psz
);

Parameter

[in] dwFieldID

Art: DWORD

Der Bezeichner für das Feld, das aktualisiert werden muss.

[in] psz

Typ: LPCWSTR

Ein Zeiger auf einen Puffer, der den neuen Text enthält.

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 optional.

Bewährte Methoden des Anmeldeinformationsanbieters

Anmeldeinformationsanbieter behandeln ä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 Techniken für die Verarbeitung geheimer Informationen 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 Zeit 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