ISSOTicket.RedeemTicket-Methode

Artikel
07/21/2023

Die RedeemTicket-Methode löst ein Enterprise Single Sign-On (SSO)-Serverticket ein, das zuvor mit der IssueTicket-Methode ausgestellt wurde.

Syntax

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

Parameter

bstrApplicationName
[in] Zeichenfolge, die den Anwendungsnamen angibt. Dieser Parameter darf nicht den Wert NULL erhalten, eine leere Zeichenfolge sein oder Leerzeichen enthalten. Bei Anwendungsnamen wird die Groß-/Kleinschreibung nicht beachtet, aber die Groß-/Kleinschreibung wird beibehalten. Bei Namen wie ABC, abc und AbC wird beispielsweise davon ausgegangen, dass es sich um dieselbe Anwendung handelt.

bstrTicket
[in] Zeichenfolge, die den von der IssueTicket-Methode abgerufenen Ticketwert angibt.

lFlags
[in] Lange ganze Zahl, die die festzulegenden Flags angibt. Mithilfe des Flags SSO_FLAG_REFRESH wird angegeben, dass der Anmeldeinformationscache umgangen werden soll.

pbstrExternalUserName
[out] Zeiger auf eine Zeichenfolge, die den externen Benutzernamen empfängt, der dem Ticket zugeordnet ist.

BSTR
[out] Zeichenfolge, die die externen Anmeldeinformationen empfängt, die dem Ticket zugeordnet sind. Wenn keine Anmeldeinformationen vorhanden sind, wird ein leeres Array zurückgegeben.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das angibt, ob sie erfolgreich abgeschlossen wurde. Weitere Informationen finden Sie im Abschnitt Fehlerwerte.

Fehlerwerte

Diese Methode gibt ein HRESULT zurück, das einen der Werte in der folgenden Tabelle enthält.

value	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_ACCESSDENIED	Dem Aufrufer wurde der Zugriff verweigert.
E_INVALIDARG	Ein ungültiger Parameter wurde erkannt.

Bemerkungen

Da die Anmeldeinformationen durch diese Methode im Klartext zurückgegeben werden, sollten diese vom Aufrufer unmittelbar nach der Verwendung gelöscht (überschrieben) werden.

Um auf diese Methode zugreifen zu können, müssen Sie SSO-Administrator, SSO-Partneradministrator oder Anwendungsadministrator sein.

Requirements (Anforderungen)

Plattformen: Fenster

Weitere Informationen

ISSOTicket-Schnittstelle (COM)
ISSOTicket-Member
Programmieren mit Einmaligem Anmelden für Unternehmen

Freigeben über