ICredentialProviderCredential::SetStringValue-Methode (credentialprovider.h)

Artikel
02/24/2024

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

Freigeben über