3.1.4.2 CreateApplication

This operation is used to create a new target application in the specified SSS partition.

The following is the WSDL port type specification of the CreateApplication WSDL operation.

 <wsdl:operation name="CreateApplication" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:input wsaw:Action="http://schemas.microsoft.com/sharepoint/2009/06/securestoreservice/ISecureStoreServiceApplication/CreateApplication" message="tns:ISecureStoreServiceApplication_CreateApplication_InputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:output wsaw:Action="http://schemas.microsoft.com/sharepoint/2009/06/securestoreservice/ISecureStoreServiceApplication/CreateApplicationResponse" message="tns:ISecureStoreServiceApplication_CreateApplication_OutputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://schemas.microsoft.com/sharepoint/2009/06/securestoreservice/ISecureStoreServiceApplication/CreateApplicationArgumentExceptionFault" name="ArgumentExceptionFault" message="tns:ISecureStoreServiceApplication_CreateApplication_ArgumentExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://schemas.microsoft.com/sharepoint/2009/06/securestoreservice/ISecureStoreServiceApplication/CreateApplicationArgumentNullExceptionFault" name="ArgumentNullExceptionFault" message="tns:ISecureStoreServiceApplication_CreateApplication_ArgumentNullExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://schemas.microsoft.com/sharepoint/2009/06/securestoreservice/ISecureStoreServiceApplication/CreateApplicationArgumentOutOfRangeExceptionFault" name="ArgumentOutOfRangeExceptionFault" message="tns:ISecureStoreServiceApplication_CreateApplication_ArgumentOutOfRangeExceptionFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://schemas.microsoft.com/sharepoint/2009/06/securestoreservice/ISecureStoreServiceApplication/CreateApplicationSecureStoreServiceFaultFault" name="SecureStoreServiceFaultFault" message="tns:ISecureStoreServiceApplication_CreateApplication_SecureStoreServiceFaultFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
 </wsdl:operation>

The protocol client sends an ISecureStoreServiceApplication_CreateApplication_InputMessage request message and the protocol server MUST respond with an ISecureStoreServiceApplication_CreateApplication_OutputMessage response message.

When a target application is created, the protocol client MUST specify claims for target application administrators. If the target application type is Group, the protocol client MUST specify the groupClaims member of the applicationClaims parameter. If the target application type is IndividualWithTicketing or GroupWithTicketing, the protocol client MUST specify the ticketRedeemerClaims member of the applicationClaims parameter.

If any one of the conditions in the following table is met, the protocol server MUST respond with a SOAP fault containing the corresponding error complex type, serialized as specified in section 2.2.2.1. If more than one error condition is encountered, the protocol server MUST respond with exactly one error complex type, determined in an implementation-specific manner.

Error Complex Type

Condition

ArgumentException

The administratorClaims member in the specified applicationClaims parameter is NULL or empty.

ArgumentException

The target application is group target application, but the groupClaims member in the specified applicationClaims parameter is NULL or empty.

ArgumentException

The target application type is IndividualWithTicketing or GroupWithTicketing, but the ticketRedeemerClaims member in the specified applicationClaims parameter is NULL or empty.

ArgumentException

The contactEmail member of the application parameter is not a valid email address, as determined using implementation-specific checks, or its length is greater than 128.

ArgumentException

The applicationId member of the application parameter has a length equal to 0 or greater than 256.

ArgumentException

The friendlyName member of the application parameter has a length equal to zero or greater than 256.

ArgumentException

The type member of the application parameter is not a valid TargetApplicationType.

ArgumentException

The credentialManagementUrl member of the application parameter is not a valid URL or its length is greater than 2084.

ArgumentOutOfRangeException

The number of target application fields in the specified applicationFields parameter is zero or greater than 10.

ArgumentOutOfRangeException

The target application type is IndividualWithTicketing or GroupWithTicketing, but the ticketTimeout member of application parameter is 0 or greater than 525600.<21>

SecureStoreServiceFault

The caller failed an implementation-specific authorization check for creating the target application.

SecureStoreServiceFault

The protocol server does not have a master secret key.

SecureStoreServiceFault

An implementation-specific validation of rawPartitionId failed.

SecureStoreServiceFault

The specified target application already exists.