ICredentialProviderUser::GetStringValue-Methode (credentialprovider.h)
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
| 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 |