ISCrdEnr::setUserName 方法
setUserName方法會指定代表憑證註冊的使用者名稱。
語法
HRESULT setUserName(
[in] DWORD dwFlags,
[in] BSTR bstrUserName
);
SCrdEnr.setUserName( _
ByVal dwFlags, _
ByVal bstrUserName _
)
參數
-
dwFlags [in]
-
此值必須定義為 1) 或定義為 2) SCARD_ENROLL_SAM_COMPATIBLE_NAME (SCARD_ENROLL_UPN_NAME (。
如果 bstrUserName 中指定的名稱是使用者的通用主體名稱,請將此值設定為 SCARD_ENROLL_UPN_NAME,例如 「 someone@example.com 」。 使用者的 UPN 名稱必須對應至現有的安全性存取管理員, (SAM) 名稱。
如果 bstrUserName 中指定的名稱是 「DOMAIN\USER」 格式的使用者 SAM 名稱,請將此值設定為 SCARD_ENROLL_SAM_COMPATIBLE_NAME。
-
bstrUserName [in]
-
使用者名稱。
傳回值
VB
如果方法成功,方法會傳回S_OK。
如果方法失敗,它會傳回指出錯誤的 HRESULT 值。 如需常見錯誤碼的清單,請參閱 一般 HRESULT 值。
備註
呼叫這個方法,以指定要發出 智慧卡的使用者名稱。 setUserName的替代方法是ISCrdEnr::selectUserName。
指定使用者名稱之後,可以藉由呼叫 getUserName來擷取其值。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
都不支援 |
最低支援的伺服器 |
Windows Server 2003 [僅限桌面應用程式] |
DLL |
|
IID |
IID_ISCrdEnr定義為 753988a1-1357-436d-9cf5-f089bdd67d64 |
另請參閱