3.1.4.16 GetRestrictedCredentials

This operation is used to retrieve the credentials of the caller for the specified target application in the specified SSS partition, when the type of the specified target application is either RestrictedIndividual or RestrictedGroup.

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

 <wsdl:operation name="GetRestrictedCredentials" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
   <wsdl:input wsaw:Action="http://schemas.microsoft.com/sharepoint/2009/06/securestoreservice/ISecureStoreServiceApplication/GetRestrictedCredentials" message="tns:ISecureStoreServiceApplication_GetRestrictedCredentials_InputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:output wsaw:Action="http://schemas.microsoft.com/sharepoint/2009/06/securestoreservice/ISecureStoreServiceApplication/GetRestrictedCredentialsResponse" message="tns:ISecureStoreServiceApplication_GetRestrictedCredentials_OutputMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://schemas.microsoft.com/sharepoint/2009/06/securestoreservice/ISecureStoreServiceApplication/GetRestrictedCredentialsArgumentExceptionFault" name="ArgumentExceptionFault" message="tns:ISecureStoreServiceApplication_GetRestrictedCredentials_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/GetRestrictedCredentialsArgumentNullExceptionFault" name="ArgumentNullExceptionFault" message="tns:ISecureStoreServiceApplication_GetRestrictedCredentials_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/GetRestrictedCredentialsSecureStoreServiceCredentialsNotFoundFaultFault" name="SecureStoreServiceCredentialsNotFoundFaultFault" message="tns:ISecureStoreServiceApplication_GetRestrictedCredentials_SecureStoreServiceCredentialsNotFoundFaultFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://schemas.microsoft.com/sharepoint/2009/06/securestoreservice/ISecureStoreServiceApplication/GetRestrictedCredentialsSecureStoreServiceFaultFault" name="SecureStoreServiceFaultFault" message="tns:ISecureStoreServiceApplication_GetRestrictedCredentials_SecureStoreServiceFaultFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
   <wsdl:fault wsaw:Action="http://schemas.microsoft.com/sharepoint/2009/06/securestoreservice/ISecureStoreServiceApplication/GetRestrictedCredentialsSecureStoreServiceTargetApplicationNotFoundFaultFault" name="SecureStoreServiceTargetApplicationNotFoundFaultFault" message="tns:ISecureStoreServiceApplication_GetRestrictedCredentials_SecureStoreServiceTargetApplicationNotFoundFaultFault_FaultMessage" xmlns:wsaw="http://www.w3.org/2006/05/addressing/wsdl"/>
 </wsdl:operation>

The protocol client sends an ISecureStoreServiceApplication_GetRestrictedCredentials_InputMessage request message and the protocol server responds with an ISecureStoreServiceApplication_GetRestrictedCredentials_OutputMessage response message.

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 length of the specified applicationId parameter is 0 or greater than 256.
SecureStoreServiceCredentialsNotFoundFault	The credentials are not found for the target application identified by the specified applicationId parameter.
SecureStoreServiceFault	The specified rawPartitionId parameter is NULL or an implementation specific validation of rawPartitionId failed.
SecureStoreServiceFault	The protocol server does not have a master secret key.
SecureStoreServiceTargetApplicationNotFoundFault	The target application specified by the applicationId parameter cannot be found in the SSS store.