Método ISSOAdmin.CreateApplication

Artículo
12/14/2023

El método CreateApplication crea una aplicación en la base de datos del servidor Enterprise Single Sign-On (SSO).

Sintaxis

  
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  
)

Parámetros

bstrApplicationName
[in] Cadena que especifica el nombre de la aplicación. Este parámetro no puede ser NULL, una cadena vacía ni incluir espacios. Los nombres de aplicación no distinguen mayúsculas de minúsculas, pero se conservarán las mayúsculas y minúsculas. Por ejemplo, ABC, abc y AbC se consideran la misma aplicación.

bstrDescription
[in] Cadena que especifica la descripción de la aplicación. Este parámetro puede ser NULL o una cadena vacía, o contener espacios.

bstrContactInfo
[in] Cadena que especifica la información de contacto de esta aplicación. Este parámetro puede ser NULL o una cadena vacía, o contener espacios.

bstrUserGroupName
[in] Cadena que especifica el nombre del grupo de usuarios de la aplicación. Este parámetro debe contener un grupo global válido.

bstrAdminGroupName
[in] Cadena que especifica el nombre del grupo Administrador de aplicaciones. Este parámetro debe contener un grupo global válido.

lFlags
[in] Entero largo que especifica si la aplicación es una aplicación de grupo. Si se necesita una aplicación de grupo, especifique SSO_FLAG_APP_USES_GROUP_MAPPING.

lNumFields
[in] Entero largo que especifica el número de campos que se agregarán para esta aplicación. El valor mínimo es 1 (un identificador de usuario externo). Una aplicación no puede tener campos de credencial.

Valor devuelto

Este método devuelve un valor HRESULT que indica si se ha completado correctamente. Para obtener información más detallada, consulte la sección Valores de error.

No es aplicable.

Valores de error

Este método devuelve un HRESULT que contiene uno de los valores de la siguiente tabla.

Este método indica errores estableciendo la propiedad Number del objeto Err global en uno de los valores de la tabla siguiente.

Valor	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_ACCESSDENIED	Acceso denegado al autor de la llamada.
E_INVALIDARG	Se ha detectado un parámetro no válido.

Comentarios

En el momento de crearse, la aplicación está siempre deshabilitada.

Después de agregar la información del campo mediante el método CreateFieldInfo , la aplicación se puede habilitar mediante el método UpdateApplication . El número de campos agregados por CreateFieldInfo debe coincidir con el número de campos especificados por el parámetro numFields . El valor numFields no se puede cambiar después de crear la aplicación.

Para obtener acceso a este método, debe ser administrador de SSO o administrador afiliado de SSO.

Requisitos

Plataformas: Windows Server 2022, Windows Server 2019, Windows Server 2016, Windows 11 y Windows 10

Consulte también

Programación con Enterprise Single Sign-On
Interfaz ISSOAdmin (COM)
Miembros de ISSOAdmin

Compartir a través de