2.2.3.120.2 Name (Search)

The Name element is a required child element of the Store element in Search command requests that specifies the store to search.

All elements referenced in this section are defined in the Search namespace.

Command request/response

Parent elements

Child elements

Data type

Number allowed

Search command request (section 2.2.1.16)

Store (section 2.2.3.178.3)

None

string ([MS-ASDTYPE] section 2.7)

1...1 (required)

The Name element value can be up to 256 characters in length. The following values are valid for the Name element for most protocol versions. Details about protocol versions are provided at the end of this section.

  • "GAL"—The client specifies "GAL" when it intends to search the Global Address List.

  • "Mailbox"—The client specifies "Mailbox" when it intends to search the mailbox.

  • "DocumentLibrary"—The client specifies "DocumentLibrary" when it intends to search a Windows SharePoint Services library or a UNC library.

Protocol Versions

The following table specifies the protocol versions that support this element. The client indicates the protocol version being used by setting either the MS-ASProtocolVersion header, as specified in [MS-ASHTTP] section 2.2.1.1.2.6, or the Protocol version field, as specified in [MS-ASHTTP] section 2.2.1.1.1.1, in the request.

Protocol version

Element support

2.5

Yes

12.0

Yes

12.1

Yes

14.0

Yes

14.1

Yes

16.0

Yes

16.1

Yes

The protocol version 2.5 does not support searches of the mailbox, a Windows SharePoint Services library, or a UNC library. Therefore, the values "Mailbox" and "DocumentLibrary" are not valid when protocol version 2.5 is used.