ICredentialProviderCredential::GetStringValue-Methode (credentialprovider.h)

  • Artikel

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