ISCrdEnr::setUserName-Methode
Die setUserName-Methode gibt den Namen des Benutzers an, für den die Zertifikatregistrierung vorgesehen ist.
Syntax
HRESULT setUserName(
[in] DWORD dwFlags,
[in] BSTR bstrUserName
);
SCrdEnr.setUserName( _
ByVal dwFlags, _
ByVal bstrUserName _
)
Parameter
-
dwFlags [in]
-
Dieser Wert muss entweder SCARD_ENROLL_UPN_NAME (definiert als 1) oder SCARD_ENROLL_SAM_COMPATIBLE_NAME (definiert als 2) sein.
Legen Sie diesen Wert auf SCARD_ENROLL_UPN_NAME fest, wenn der in bstrUserName angegebene Name der Universelle Prinzipalname des Benutzers ist, z. B. "someone@example.com". Der UPN-Name des Benutzers muss einem vorhandenen SAM-Namen (Security Access Manager) entsprechen.
Legen Sie diesen Wert auf SCARD_ENROLL_SAM_COMPATIBLE_NAME fest, wenn der in bstrUserName angegebene Name der SAM-Name des Benutzers im Format "DOMAIN\USER" ist.
-
bstrUserName [in]
-
Name des Benutzers.
Rückgabewert
VB
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.
Bemerkungen
Rufen Sie diese Methode auf, um den Benutzernamen anzugeben, der für die smarte Karte ausgegeben werden soll. Eine Alternative zu setUserName ist ISCrdEnr::selectUserName.
Nachdem ein Benutzername angegeben wurde, kann sein Wert abgerufen werden, indem getUserName aufgerufen wird.
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