ISSOAdmin.CreateApplication-Methode

Artikel
07/21/2023

Die CreateApplication-Methode erstellt eine Anwendung in der Serverdatenbank enterprise Single Sign-On (SSO).

Syntax

  
HRESULT CreateApplication(  
BSTR bstrApplicationName,  
BSTR bstrDescription,  
BSTR bstrContactInfo,  
BSTR bstrUserGroupName,  
BSTR bstrAdminGroupName,  
LONG lFlags,  
LONG lNumFields  
);

  
[Visual Basic]  
Sub CreateApplication(  
bstrApplicationName As String,  
bstrDescription As String,  
bstrContactInfo As String,  
bstrUserGroupName As String,  
bstrAdminGroupName As String,  
lFlags As Long,  
lNumFields As Long  
)

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.

bstrDescription
[in] Zeichenfolge, die die Beschreibung für die Anwendung angibt. Dieser Parameter darf den Wert NULL erhalten, eine leere Zeichenfolge sein oder Leerzeichen enthalten.

bstrContactInfo
[in] Zeichenfolge, die die Kontaktinformationen für diese Anwendung angibt. Dieser Parameter darf den Wert NULL erhalten, eine leere Zeichenfolge sein oder Leerzeichen enthalten.

bstrUserGroupName
[in] Zeichenfolge, die den Namen der Anwendungsbenutzergruppe angibt. Dieser Parameter muss eine gültige globale Gruppe enthalten.

bstrAdminGroupName
[in] Zeichenfolge, die den Namen der Anwendungsadministratorgruppe angibt. Dieser Parameter muss eine gültige globale Gruppe enthalten.

lFlags
[in] Lange ganze Zahl, die angibt, ob es sich bei der Anwendung um eine Gruppenanwendung handelt. Wenn eine Gruppenanwendung erforderlich ist, geben Sie SSO_FLAG_APP_USES_GROUP_MAPPING an.

lNumFields
[in] Lange ganze Zahl, die die Anzahl der Felder angibt, die für diese Anwendung hinzugefügt werden. Der Minimalwert ist in der Standardeinstellung 1 (eine externe Benutzer-ID). Anwendungen müssen nicht über Anmeldeinformationsfelder verfügen.

Rückgabewert

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

Nicht zutreffend.

Fehlerwerte

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

Diese Methode gibt Fehler an, indem die Number-Eigenschaft des globalen Err-Objekts auf einen der Werte in der folgenden Tabelle festgelegt wird.

Wert	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.

Hinweise

Anwendungen sind beim Erstellen stets deaktiviert.

Nachdem die Feldinformationen mithilfe der CreateFieldInfo-Methode hinzugefügt wurden, kann die Anwendung mithilfe der UpdateApplication-Methode aktiviert werden. Die Anzahl der von CreateFieldInfo hinzugefügten Felder muss mit der Anzahl von Feldern übereinstimmen, die durch den numFields-Parameter angegeben wird. Der NumFields-Wert kann nicht geändert werden, nachdem die Anwendung erstellt wurde.

Für den Zugriff auf diese Methode müssen Sie SSO-Administrator oder SSO-Partneradministrator sein.

Anforderungen

Plattformen: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 und Windows 10

Weitere Informationen

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

Freigeben über