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