ISCrdEnr：：getUserName 方法
getUserName 方法检索要代表其进行证书注册的用户的名称。
在调用此方法之前，必须在对 ISCrdEnr：：selectUserName 或 ISCrdEnr：：setUserName 的调用中指定用户名。
语法
HRESULT getUserName(
[in] DWORD dwFlags,
[out] BSTR *pbstrUserName
);
SCrdEnr.getUserName( _
ByVal dwFlags, _
ByRef pbstrUserName _
)
parameters
-
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]
-
指向返回用户名的字符串的指针。
返回值
C++
如果该方法成功，该方法将返回S_OK。
如果方法失败，它将返回指示错误的 HRESULT 值。 有关常见错误代码的列表，请参阅 常见 HRESULT 值。
VB
表示用户名的字符串。
备注
可以通过调用 ISCrdEnr：：setUserName 或 ISCrdEnr：：selectUserName 来指定向其发出智能卡的用户的名称。 指定用户名后，可以通过调用 getUserName 来检索其值。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
无受支持的版本 |
| 最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
| DLL |
|
| IID |
IID_ISCrdEnr定义为 753988a1-1357-436d-9cf5-f089bdd67d64 |
另请参阅