ISSOAdmin.UpdateApplication-Methode

Artikel
12/14/2023

Die UpdateApplication-Methode aktualisiert die Anwendungsinformationen in der Serverdatenbank enterprise Single Sign-On (SSO).

Syntax

  
HRESULT UpdateApplication(  
BSTR bstrApplicationName,  
BSTR bstrDescription,  
BSTR bstrContactInfo,  
BSTR bstrUserGroupName,  
BSTR bstrAdminGroupName,  
LONG lFlags,  
LONG lFlagMask  
);

  
Function UpdateApplication(  
bstrApplicationName As String,  
bstrDescription As String,  
bstrContactInfo As String,  
bstrUserGroupName As String,  
bstrAdminGroupName As String,  
lFlags 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 der Anwendung angibt.

bstrContactInfo
[in] Zeichenfolge, die die Kontaktinformationen für diese Anwendung angibt.

bstrUserGroupName
[in] Zeichenfolge, die den Namen der Gruppe Anwendungsbenutzer angibt. Dabei muss es sich um eine gültige globale Gruppe handeln.

bstrAdminGroupName
[in] Zeichenfolge, die den Namen der Anwendungsadministratorgruppe angibt. Dabei muss es sich um eine gültige globale Gruppe handeln. Bei der Ausführung als Anwendungsadministrator wird dieser Parameter ignoriert.

lFlags
[in] Eine ganze Zahl, die angibt, ob die Anwendung aktiviert ist. Legen Sie das Flag "SSO_FLAG_ENABLED" fest, um die Anwendung zu aktivieren.

lFlagMask
[in] Um den Flagwert zu ändern, legen Sie diese Maske auf das Flag fest, das Sie ändern müssen. Um beispielsweise SSO für Unternehmen zu aktivieren oder zu deaktivieren, legen Sie für dieses Flag "SSO_FLAG_ENABLED" fest. Der flagMask-Parameter gibt an, welches Flag Sie ändern möchten, während der flags-Parameter den neuen Wert dieses Flags angibt.

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

Um auf diese Methode zugreifen zu können, müssen Sie SSO-Administrator, SSO-Partneradministrator oder Anwendungsadministrator 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