ISCrdEnr::getUserName-Methode

Die getUserName-Methode ruft den Namen des Benutzers ab, in dessen Namen die Zertifikatregistrierung vorgesehen ist.

Bevor Sie diese Methode aufrufen, 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 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 die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

VB

Zeichenfolge, die den Namen des Benutzers darstellt.

Bemerkungen

Sie können den Namen des Benutzers angeben, für den die intelligente Karte 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.

Anforderungen

Siehe auch

ISCrdEnr

ISCrdEnr::resetUser

ISCrdEnr::selectUserName

ISCrdEnr::setUserName