ISCrdEnr：：getUserName 方法

getUserName 方法检索要代表其进行证书注册的用户的名称。

在调用此方法之前，必须在对 ISCrdEnr：：selectUserName 或 ISCrdEnr：：setUserName 的调用中指定用户名。

语法

HRESULT getUserName(
  [in]  DWORD     dwFlags,
  [out] BSTR *pbstrUserName
);


SCrdEnr.getUserName( _
  ByVal dwFlags, _
  ByRef pbstrUserName _
)

dwFlags [in]

此值必须为零 (0) 、SCARD_ENROLL_UPN_NAME 或 SCARD_ENROLL_SAM_COMPATIBLE_NAME。

如果此值为SCARD_ENROLL_UPN_NAME， 则 getUserName 将返回用户的通用主体名称 (UPN) ，例如“someone@example.com”。

如果此值为SCARD_ENROLL_SAM_COMPATIBLE_NAME，则该方法以“DOMAIN\USER”格式返回用户的安全访问管理器 (SAM) 名称。

如果此值为零，则该方法返回用户的 UPN 名称（如果存在）。如果用户没有 UPN 名称，该方法将返回用户的 SAM 名称。

pbstrUserName [out]

指向返回用户名的字符串的指针。

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

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

表示用户名的字符串。

可以通过调用 ISCrdEnr：：setUserName 或 ISCrdEnr：：selectUserName 来指定向其发出智能卡的用户的名称。指定用户名后，可以通过调用 getUserName 来检索其值。