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
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Nicht unterstützt |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| DLL |
|
| IID |
IID_ISCrdEnr ist definiert als 753988a1-1357-436d-9cf5-f089bdd67d64 |
Siehe auch