ISCrdEnr::getUserName メソッド
getUserName メソッドは、証明書の登録を目的とするユーザーの名前を取得します。
このメソッドを呼び出す前に、 ISCrdEnr::selectUserName または ISCrdEnr::setUserName の呼び出しでユーザー名 を指定する必要があります。
構文
HRESULT getUserName(
[in] DWORD dwFlags,
[out] BSTR *pbstrUserName
);
SCrdEnr.getUserName( _
ByVal dwFlags, _
ByRef pbstrUserName _
)
パラメーター
-
dwFlags [in]
-
この値は、0 (0)、SCARD_ENROLL_UPN_NAME、またはSCARD_ENROLL_SAM_COMPATIBLE_NAMEのいずれかである必要があります。
この値がSCARD_ENROLL_UPN_NAMEの場合、 getUserName は"someone@example.com" などのユーザーのユニバーサル プリンシパル名 (UPN) を返します。
この値がSCARD_ENROLL_SAM_COMPATIBLE_NAMEの場合、 メソッドはユーザーのセキュリティ アクセス マネージャー (SAM) 名を "DOMAIN\USER" という形式で返します。
この値が 0 の場合、メソッドはユーザーの 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 として定義されています |
関連項目