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]

使用者名稱。

如果方法成功，方法會傳回S_OK。

如果方法失敗，它會傳回指出錯誤的 HRESULT 值。如需常見錯誤碼的清單，請參閱一般 HRESULT 值。

呼叫這個方法，以指定要發出 智慧卡的使用者名稱。 setUserName的替代方法是ISCrdEnr：：selectUserName。

指定使用者名稱之後，可以藉由呼叫 getUserName來擷取其值。