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

Siehe auch

ISCrdEnr

ISCrdEnr::getUserName

ISCrdEnr::resetUser

ISCrdEnr::selectUserName