ICredentialProviderUser::GetStringValue-Methode (credentialprovider.h)

  • Artikel

Ruft Zeichenfolgeneigenschaften basierend auf dem Eingabewert aus dem ICredentialProviderUser-Objekt ab.

Syntax

HRESULT GetStringValue(
  [in]  REFPROPERTYKEY key,
  [out] LPWSTR         *stringValue
);

Parameter

[in] key

Einer der folgenden Werte, der die abzurufende Eigenschaft angibt.

REFPROPERTYKEY BESCHREIBUNG Gilt für...
PKEY_Identity_DisplayName Der Anzeigebenutzername. Benutzeroberfläche für Anmeldung und Anmeldeinformationen
PKEY_Identity_LogonStatusString Eine lokalisierte Zeichenfolge, die den angemeldeten Benutzer status angibt. Nur Anmelde-Benutzeroberfläche
PKEY_Identity_PrimarySid Die SID des Benutzers. Benutzeroberfläche für Anmeldung und Anmeldeinformationen
PKEY_Identity_ProviderID Die Anbieter-ID des Benutzers. Benutzeroberfläche für Anmeldung und Anmeldeinformationen
PKEY_Identity_QualifiedUserName Der Name, der zum Packen eines Authentifizierungspuffers verwendet wird. Benutzeroberfläche für Anmeldung und Anmeldeinformationen
PKEY_Identity_UserName Der Benutzername. Benutzeroberfläche für Anmeldung und Anmeldeinformationen

[out] stringValue

Die Adresse eines Zeigers auf einen Puffer, der die angeforderte Zeichenfolge empfängt, wenn diese Methode erfolgreich zurückgegeben wird.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Jeder dieser Werte kann auch als PROPVARIANT über ICredentialProviderUser::GetValue abgerufen werden.

Stellen Sie sich ein Szenario mit den folgenden Benutzern vor.

  • Domänenbenutzer:
    • Domäne: contoso
    • Benutzername: lisa
    • Anzeigename: Lisa Andrews
  • Lokaler Benutzer:
    • PC-Name: lisa-pc
    • Benutzername: lisa
    • Anzeigename: Lisa Andrews
  • Microsoft-Konto:
    • E-Mail-Adresse: lisa@contoso.com
    • Anzeigename: Lisa Andrews
In diesem Szenario enthält die folgende Tabelle einige Beispieldaten für jeden der Schlüsselwerte .
REFPROPERTYKEY Domänenbenutzer Lokaler Benutzer Microsoft-Konto
PKEY_Identity_DisplayName "Lisa Andrews" "Lisa Andrews" "Lisa Andrews"
PKEY_Identity_LogonStatusString "Angemeldet" "Gesperrt" "Remote angemeldet von lisa-pc"
PKEY_Identity_PrimarySid "{S-1-5-21-2279990834-2601404236-735077814-1001}" "{S-1-5-21-2279990834-2601404236-735077814-1001}" "{S-1-5-21-2279990834-2601404236-735077814-1001}"
PKEY_Identity_ProviderID "{A198529B-730F-4089-B646-A12557F5665E}" "{A198529B-730F-4089-B646-A12557F5665E}" Nicht vordefiniert
PKEY_Identity_QualifiedUserName "contoso\lisa" "lisa-pc\lisa" "<Kontoanbietername>\lisa@contoso.com"
PKEY_Identity_UserName "contoso\lisa" "lisa" "lisa@contoso.com"

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile credentialprovider.h
Bibliothek CredentialProvider.lib
DLL Authui.dll

Weitere Informationen

ICredentialProviderUser

ICredentialProviderUser::GetValue