ISCrdEnr：：setUserName 方法

setUserName 方法指定用于注册证书的用户的名称。

语法

HRESULT setUserName(
  [in] DWORD dwFlags,
  [in] BSTR bstrUserName
);


SCrdEnr.setUserName( _
  ByVal dwFlags, _
  ByVal bstrUserName _
)

dwFlags [in]

此值必须SCARD_ENROLL_UPN_NAME (定义为 1) 或SCARD_ENROLL_SAM_COMPATIBLE_NAME (定义为 2) 。

如果 bstrUserName 中指定的名称是用户的通用主体名称（如“”），请将此值设置为 SCARD_ENROLL_UPN_NAMEsomeone@example.com。用户的 UPN 名称必须与现有的安全访问管理器相对应， (SAM) 名称。

如果 bstrUserName 中指定的名称是“DOMAIN\USER”格式的用户 SAM 名称，请将此值设置为 SCARD_ENROLL_SAM_COMPATIBLE_NAME。

bstrUserName [in]

用户的名称。

如果该方法成功，该方法将返回S_OK。

如果方法失败，它将返回指示错误的 HRESULT 值。有关常见错误代码的列表，请参阅常见 HRESULT 值。

调用此方法可指定要颁发智能卡的用户名。 setUserName 的替代项是 ISCrdEnr：：selectUserName。

指定用户名后，可以通过调用 getUserName 来检索其值。