ICredentialProviderCredential::GetStringValue-Methode (credentialprovider.h)

Artikel
02/24/2024

Ermöglicht das Abrufen von Text aus anmeldeinformationen mit einem Textfeld.

Syntax

HRESULT GetStringValue(
  [in]  DWORD  dwFieldID,
  [out] LPWSTR *ppsz
);

Parameter

[in] dwFieldID

Art: DWORD

Der Bezeichner für das Feld.

[out] ppsz

Typ: LPWSTR*

Ein Zeiger auf den Arbeitsspeicher, der eine Unicode-Zeichenfolge mit Null-Beendigung enthält, um zur Anmeldebenutzeroberfläche oder zur Anmeldeinformationsbenutzeroberfläche zurückzukehren.

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.

Mit der Anmeldebenutzeroberfläche und der Anmeldeinformations-UI können Sie das pszLabel für ein Feld abrufen. Diese Informationen sind erforderlich, um Werte für die Felder CPFT_LARGE_TEXT, CPFT_SMALL_TEXT, CPFT_COMMAND_LINK, CPFT_EDIT_TEXT und CPFT_PASSWORD_TEXT abzurufen.

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