Compartir a través de

Método ISSOTicket.RedeemTicket

  • Artículo

 

El método RedeemTicket canjea un vale de servidor enterprise Single Sign-On (SSO) que se emitió anteriormente con el método IssueTicket .

Sintaxis

  
HRESULT RedeemTicket(  
BSTR bstrApplicationName,  
BSTR bstrTicket,  
LONG lFlags,  
BSTR* pbstrExternalUserName,  
SAFEARRAY BSTR  
);

Parámetros

bstrApplicationName
[in] Cadena que especifica el nombre de la aplicación. Este parámetro no puede ser NULL, una cadena vacía ni incluir espacios. Los nombres de aplicación no distinguen mayúsculas de minúsculas, pero se conservarán mayúsculas de minúsculas. Por ejemplo, ABC, abc y AbC se consideran la misma aplicación.

bstrTicket
[in] Cadena que especifica el valor del vale obtenido del método IssueTicket .

lFlags
[in] Entero largo que especifica las marcas que se van a establecer. Use la marca SSO_FLAG_REFRESH para indicar que la caché de credenciales debe omitirse.

pbstrExternalUserName
[out] Puntero a una cadena que recibe el nombre de usuario externo asociado al vale.

BSTR
[out] Cadena que recibe las credenciales externas asociadas al vale. Si no hay credenciales, el tamaño de la matriz devuelta es cero.

Valor devuelto

Este método devuelve un valor HRESULT que indica si se ha completado correctamente. Para obtener información más detallada, consulte la sección Valores de error.

Valores de error

Este método devuelve un HRESULT que contiene uno de los valores de la siguiente tabla.

Valor Descripción
S_OK El método se ha llevado a cabo de forma correcta.
E_ACCESSDENIED Acceso denegado al autor de la llamada.
E_INVALIDARG Se ha detectado un parámetro no válido.

Comentarios

Debido a que las credenciales se devuelven en texto sin formato a través de este método, el autor de la llamada debe actuar con precaución para borrarlos (sobrescribirlos) lo antes posible, tras su uso.

Para obtener acceso a este método, debe ser un administrador de SSO, administrador afiliado de SSO o un administrador de aplicación.

Requisitos

Plataformas: Windows

Consulte también

Interfaz ISSOTicket (COM)
Miembros de ISSOTicket
Programación con Enterprise Single Sign-On