Método ISCrdEnr::getUserName
El método getUserName recupera el nombre del usuario en cuyo nombre está previsto la inscripción del certificado.
Antes de llamar a este método, debe especificar el nombre de usuario en una llamada a ISCrdEnr::selectUserName o ISCrdEnr::setUserName.
Sintaxis
HRESULT getUserName(
[in] DWORD dwFlags,
[out] BSTR *pbstrUserName
);
SCrdEnr.getUserName( _
ByVal dwFlags, _
ByRef pbstrUserName _
)
Parámetros
-
dwFlags [in]
-
Este valor debe ser cero (0), SCARD_ENROLL_UPN_NAME o SCARD_ENROLL_SAM_COMPATIBLE_NAME.
Si este valor es SCARD_ENROLL_UPN_NAME, getUserName devuelve el nombre principal universal (UPN) del usuario, como "someone@example.com".
Si este valor es SCARD_ENROLL_SAM_COMPATIBLE_NAME, el método devuelve el nombre del administrador de acceso de seguridad (SAM) del usuario con el formato "DOMAIN\USER".
Si este valor es cero, el método devuelve el nombre upn del usuario si existe. Si el usuario no tiene un nombre UPN, el método devuelve el nombre SAM del usuario.
-
pbstrUserName [out]
-
Puntero a una cadena que devuelve el nombre del usuario.
Valor devuelto
C++
Si el método se realiza correctamente, el método devuelve S_OK.
Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.
VB
Cadena que representa el nombre del usuario.
Comentarios
Puede especificar el nombre del usuario al que se emite la tarjeta inteligente llamando a ISCrdEnr::setUserName o ISCrdEnr::selectUserName. Una vez especificado un nombre de usuario, se puede recuperar su valor llamando a getUserName.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
No se admite ninguno |
| Servidor mínimo compatible |
Windows Server 2003 [solo aplicaciones de escritorio] |
| Archivo DLL |
|
| IID |
IID_ISCrdEnr se define como 753988a1-1357-436d-9cf5-f089bdd67d64 |
Consulte también