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 |
|
| IID |
IID _ ISCrdEnr ist als 753988a1-1357-436d-9cf5-f089bdd67d64 definiert. |