ISSOAdmin.UpdateApplication, méthode

Article
07/21/2023

La méthode UpdateApplication met à jour les informations d’application dans la base de données du serveur Sign-On d’entreprise (SSO).

Syntaxe

  
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  
)

Paramètres

bstrApplicationName
[in] Chaîne qui spécifie le nom de l’application. Ce paramètre ne peut pas avoir la valeur NULL, être une chaîne vide ou contenir des espaces. Les noms d'application ne respectent pas les majuscules et minuscules, toutefois, ces dernières sont conservées. Par exemple, ABC, abc et AbC sont considérés comme la même application.

bstrDescription
[in] Chaîne qui spécifie la description de l’application.

bstrContactInfo
[in] Chaîne qui spécifie les informations de contact pour cette application.

bstrUserGroupName
[in] Chaîne qui spécifie le nom du groupe Utilisateurs de l’application. Il doit s'agir d'un groupe global valide.

bstrAdminGroupName
[in] Chaîne qui spécifie le nom du groupe Administrateur d’application. Il doit s'agir d'un groupe global valide. S'il s'exécute en tant qu'administrateur de l'application, ce paramètre sera ignoré.

lFlags
[in] Entier qui spécifie si l’application est activée. Pour activer l'application, définissez l'indicateur SSO_FLAG_ENABLED.

lFlagMask
[in] Pour modifier la valeur de l’indicateur, définissez ce masque sur l’indicateur que vous devez modifier. Par exemple, pour activer ou désactiver l'authentification unique de l'entreprise, définissez cet indicateur sur SSO_FLAG_ENABLED. Le paramètre flagMask indique l’indicateur que vous souhaitez modifier, tandis que le paramètre flags indique la nouvelle valeur de cet indicateur.

Valeur renvoyée

Cette méthode retourne un HRESULT indiquant s’il s’est terminé avec succès. Pour plus d’informations, consultez la section Valeurs d’erreur.

Non applicable.

Valeurs d'erreur

Cette méthode retourne un HRESULT contenant l’une des valeurs du tableau suivant.

Cette méthode indique les erreurs en définissant la propriété Number de l’objet Err global sur l’une des valeurs du tableau suivant.

Valeur	Description
S_OK	S_OK
E_ACCESSDENIED	L'accès à l'appelant est refusé.
E_INVALIDARG	Un paramètre non valide a été détecté.

Remarques

Pour pouvoir accéder à cette méthode, vous devez être un administrateur de l'authentification unique, un administrateur d'applications associées à l'authentification unique ou un administrateur d'application.

Configuration requise

Plates-formes: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 et Windows 10

Voir aussi

Programmation avec l’authentification unique de l’entreprise
ISSOAdmin, interface (COM)
Membres de ISSOAdmin