Metodo ISSOAdmin.CreateApplication

Articolo
12/14/2023

Il metodo CreateApplication crea un'applicazione nel database del server SSO (Enterprise Single Sign-On).

Sintassi

  
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  
)

Parametri

bstrApplicationName
[in] Stringa che specifica il nome dell'applicazione. Questo parametro non può essere NULL o una stringa vuota, né contenere spazi. I nomi delle applicazioni non tengono conto della distinzione tra maiuscole e minuscole, ma conservano la propria combinazione di maiuscole/minuscole. Ad esempio, ABC, abc e AbC sono considerati come la stessa applicazione.

bstrDescription
[in] Stringa che specifica la descrizione per l'applicazione. Questo parametro può essere NULL, una stringa vuota o contenere spazi.

bstrContactInfo
[in] Stringa che specifica le informazioni di contatto per l'applicazione. Questo parametro può essere NULL, una stringa vuota o contenere spazi.

bstrUserGroupName
[in] Stringa che specifica il nome del gruppo di utenti dell'applicazione. Questo parametro deve contenere un gruppo globale valido.

bstrAdminGroupName
[in] Stringa che specifica il nome del gruppo amministratore dell'applicazione. Questo parametro deve contenere un gruppo globale valido.

lFlags
[in] Numero intero lungo che specifica se l'applicazione è un'applicazione di gruppo. Se è necessaria un'applicazione di gruppo, specificare SSO_FLAG_APP_USES_GROUP_MAPPING.

lNumFields
[in] Numero intero lungo che specifica il numero di campi che verranno aggiunti per l'applicazione. Il valore minimo è 1 (un ID utente esterno). Un'applicazione può non avere campi di credenziali.

Valore restituito

Questo metodo restituisce un HRESULT che indica se il metodo viene completato in modo corretto. Per ulteriori dettagli, vedere la sezione relativa ai valori di errore.

Non applicabile.

Valori di errore

Questo metodo restituisce un HRESULT contenente uno dei valori riportati nella tabella seguente.

Questo metodo indica gli errori impostando la proprietà Number dell'oggetto Err globale su uno dei valori della tabella seguente.

Valore	Descrizione
S_OK	Il metodo è riuscito.
E_ACCESSDENIED	Al chiamante viene negato l'accesso.
E_INVALIDARG	È stato rilevato un parametro non valido.

Commenti

Un'applicazione viene sempre creata come disattivata.

Dopo aver aggiunto le informazioni sul campo usando il metodo CreateFieldInfo , l'applicazione può essere abilitata usando il metodo UpdateApplication . Il numero di campi aggiunti da CreateFieldInfo deve corrispondere al numero di campi specificati dal parametro numFields . Il valore numFields non può essere modificato dopo la creazione dell'applicazione.

Per accedere a questo metodo, è necessario essere un amministratore SSO o un amministratore di applicazioni affiliate SSO.

Requisiti

Piattaforme: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 e Windows 10

Vedere anche

Programmazione con Enterprise Single Sign-On
Interfaccia ISSOAdmin (COM)
Membri ISSOAdmin