3.1.4.2.2.2 SearchPrincipalsResponse

  • Article

The SearchPrincipalsResponse element provides the result data for a SearchPrincipals operation.

 <s:element name="SearchPrincipalsResponse">
   <s:complexType>
     <s:sequence>
       <s:element name="SearchPrincipalsResult" type="tns:ArrayOfPrincipalInfo" minOccurs="0" maxOccurs="1"/>
     </s:sequence>
   </s:complexType>
 </s:element>

SearchPrincipalsResult: The list of principals (1), in the format of PrincipalInfo (section 2.2.4.2) complex types, which match the specified criteria in the request uniquely or partially. This element MUST be present.

Each PrincipalInfo (section 2.2.4.2) returned MUST have the following fields:

UserInfoID: This value MUST NOT be less than -1.

IsResolved: This value MUST be set to true.

MoreMatches: This value MUST be NULL.

AccountName: This value MUST NOT be NULL.

PrincipalType: This value MUST NOT be set to All.

DisplayName: This element can be NULL, empty, or contain the resolved principal’s (1) display name field.

Title: This element can be NULL, empty, or contain the resolved principal’s (1) title field.

Department: This element can be NULL, empty, or contain the resolved principal’s (1) department field.

Email: This element can be NULL, empty, or contain the resolved principal’s (1) email field.