UserInformation.GetPrincipalNameAsync Methode

Definition

Namespace:

Windows.System.UserProfile

Ruft den Prinzipalnamen für den Benutzer ab. Dieser Name ist der Benutzerprinzipalname (in der Regel die Adresse des Benutzers, obwohl dies nicht immer der Fall ist).)

Wichtig

Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Weitere Informationen finden Sie unter Hinweise in der Dokumentation der UserInformation-Klasse .

public:
 static IAsyncOperation<Platform::String ^> ^ GetPrincipalNameAsync();

/// [Windows.Foundation.Metadata.RemoteAsync]
/// [Windows.Foundation.Metadata.Deprecated("Use User instead of UserInformation. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 131072, "Windows.System.UserProfile.UserProfileContract")]
 static IAsyncOperation<winrt::hstring> GetPrincipalNameAsync();

[Windows.Foundation.Metadata.RemoteAsync]
[Windows.Foundation.Metadata.Deprecated("Use User instead of UserInformation. For more info, see MSDN.", Windows.Foundation.Metadata.DeprecationType.Deprecate, 131072, "Windows.System.UserProfile.UserProfileContract")]
public static IAsyncOperation<string> GetPrincipalNameAsync();

function getPrincipalNameAsync()

Public Shared Function GetPrincipalNameAsync () As IAsyncOperation(Of String)

Gibt zurück

IAsyncOperation<String>

IAsyncOperation<Platform::String>

IAsyncOperation<winrt::hstring>

Der Prinzipalname des Benutzers.

Attribute

RemoteAsyncAttribute DeprecatedAttribute

Hinweise

Wichtig

Die UserInformation-Klasse wird auf Windows 10 oder höher nicht unterstützt. Verwenden Sie stattdessen die User-Klasse . Weitere Informationen finden Sie unter Hinweise in der Dokumentation der UserInformation-Klasse .

Nur Domänenbenutzer haben einen Prinzipalnamen. Der Zugriff auf den Prinzipalnamen kann durch Datenschutzeinstellungen blockiert werden (z. B. wenn die UserInformation.NameAccessAllowed-Eigenschaft false ist). Wenn der Zugriff blockiert ist, gibt diese Methode eine leere Zeichenfolge zurück.

Für diese Methode ist die EnterpriseAuthentication-Funktion erforderlich.

Diese Methode löst keine Ausnahme aus.

Weitere Informationen

• User