ISCrdEnr::getUserName-Methode

Die getUserName-Methode ruft den Namen des Benutzers ab, für den die Zertifikatregistrierung vorgesehen ist.

Vor dem Aufrufen dieser Methode müssen Sie den Benutzernamen in einem Aufruf von ISCrdEnr::selectUserName oder ISCrdEnr::setUserName angeben.

Syntax

HRESULT getUserName(
  [in]  DWORD     dwFlags,
  [out] BSTR *pbstrUserName
);

SCrdEnr.getUserName( _
  ByVal dwFlags, _
  ByRef pbstrUserName _
)

Parameter

dwFlags [ In]

Dieser Wert muss entweder null (0), SCARD _ ENROLL _ UPN _ NAME oder SCARD ENROLL SAM _ COMPATIBLE NAME _ _ _ sein.

Wenn dieser Wert SCARD _ ENROLL _ UPN _ NAME ist, gibt getUserName den Universal Principal Name (UPN) des Benutzers zurück, z. B. " someone@example.com ".

Wenn dieser Wert SCARD ENROLL SAM COMPATIBLE NAME ist, gibt die Methode den Sam-Namen (Security Access Manager) des Benutzers im Format _ _ _ _ "DOMAIN \ USER" zurück.

Wenn dieser Wert 0 (null) ist, gibt die Methode den UPN-Namen des Benutzers zurück, sofern vorhanden. Wenn der Benutzer keinen UPN-Namen hat, gibt die Methode den SAM-Namen des Benutzers zurück.

pbstrUserName [ out]

Ein Zeiger auf eine Zeichenfolge, die den Namen des Benutzers zurückgibt.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S _ OK zurück.

Wenn bei der Methode ein Fehler auftritt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Eine Liste der allgemeinen Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

VB

Eine Zeichenfolge, die den Namen des Benutzers darstellt.

Bemerkungen

Sie können den Namen des Benutzers angeben, für den die Smartcard ausgestellt wird, indem Sie entweder ISCrdEnr::setUserName oder ISCrdEnr::selectUserName aufrufen. Nachdem ein Benutzername angegeben wurde, kann sein Wert durch Aufrufen von getUserName abgerufen werden.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Nicht unterstützt
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
DLL
Scrdenrl.dll
IID
IID _ ISCrdEnr ist als 753988a1-1357-436d-9cf5-f089bdd67d64 definiert.

Weitere Informationen

ISCrdEnr

ISCrdEnr::resetUser

ISCrdEnr::selectUserName

ISCrdEnr::setUserName