ISSOAdmin.CreateFieldInfo, méthode

Article
07/21/2023

La méthode CreateFieldInfo crée des informations de champ pour une application.

Syntaxe

  
HRESULT CreateFieldInfo(  
BSTR bstrApplicationName,  
BSTR bstrLabel,  
LONG lFlags  
);

  
Sub CreateFieldInfo(  
bstrApplicationName As String,  
bstrLabel 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.

bstrLabel
[in] Chaîne qui spécifie la valeur d’étiquette. Ce paramètre ne peut pas avoir la valeur NULL ou être une chaîne vide.

lFlags
[in] L’entier long spécifie si le champ est masqué. Si un champ doit être masqué lorsqu'il est affiché dans l'interface utilisateur, spécifiez SSO_FLAG_FIELD_INFO_MASK. Le paramètre d'indicateur sera ignoré pour le premier champ (ID utilisateur) car ce dernier ne sera pas masqué.

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

L'application doit exister pour que ses informations de champ puissent être créées. Le nombre de champs ajoutés doit être égal à la valeur numFields spécifiée lors de la création de l’application. Sinon, l’application sera désactivée au moment de l’exécution.

Bien que l'ID utilisateur externe ne soit pas considéré comme une information d'identification externe, il requiert qu'un champ décrive comment il sera affiché par l'interface utilisateur. Le premier champ créé est considéré comme le champ qui décrit l’ID d’utilisateur externe. Au moins un champ est requis et au moins deux champs doivent généralement être spécifiés pour fournir des informations d’identification. Une application peut ne pas disposer d'informations d'identification.

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 de 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