ISSOAdmin.CreateApplication, méthode

Article
07/21/2023

La méthode CreateApplication crée une application dans la base de données du serveur d’entreprise Sign-On unique (SSO).

Syntaxe

  
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  
)

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. Ce paramètre peut avoir la valeur NULL, être une chaîne vide ou contenir des espaces.

bstrContactInfo
[in] Chaîne qui spécifie les informations de contact pour cette application. Ce paramètre peut avoir la valeur NULL, être une chaîne vide ou contenir des espaces.

bstrUserGroupName
[in] Chaîne qui spécifie le nom du groupe utilisateurs de l’application. Ce paramètre doit contenir un groupe global valide.

bstrAdminGroupName
[in] Chaîne qui spécifie le nom du groupe Administrateur d’application. Ce paramètre doit contenir un groupe global valide.

lFlags
[in] Entier long qui spécifie si l’application est une application de groupe. Si une application de groupe est requise, spécifiez SSO_FLAG_APP_USES_GROUP_MAPPING.

lNumFields
[in] Entier long qui spécifie le nombre de champs qui seront ajoutés pour cette application. La valeur minimale est 1 (un ID utilisateur externe). Une application peut ne pas disposer de champs d'informations d'identification.

Valeur renvoyée

Cette méthode retourne une valeur HRESULT indiquant si elle s’est terminée 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 des erreurs en définissant la propriété Number de l’objet global Err 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

Lors de sa création, une application est toujours désactivée.

Une fois les informations de champ ajoutées à l’aide de la méthode CreateFieldInfo , l’application peut être activée à l’aide de la méthode UpdateApplication . Le nombre de champs ajoutés par CreateFieldInfo doit correspondre au nombre de champs spécifié par le paramètre numFields . La valeur numFields ne peut pas être modifiée après la création de l’application.

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

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