Add validations for storage pickers

[DinahK-2SO]

Description

This pull request introduces several enhancements to the StoragePickers interop functionality, focusing on validation improvements, refactoring of file type management, and updates to the PickerLocationId enumeration. The most significant changes include adding validation methods for picker properties, introducing new classes (FileTypeFilterVector and FileTypeChoicesMap) to handle file type filtering with validation, and removing obsolete entries from the PickerLocationId enumeration.

Below validations for storage pickers are added:

Error Code	Message
IDS_APIERROR_INVALIDVIEWMODEVALUE	The specified 'ViewMode' is invalid.
IDS_APIERROR_INVALIDSUGGESTEDSTARTLOCATIONVALUE	The specified 'SuggestedStartLocation' is invalid.
IDS_APIERROR_IMPROPERFILEEXTENSION	File extensions must begin with '.' and contain no wildcards.
IDS_APIERROR_STRINGSNOEMBEDDEDNULLS	Strings cannot have embedded nulls.
IDS_APIERROR_MAXSAVEFILELENGTHEXCEEDED	The suggested file name exceeds the maximum number of characters allowed.

Their resources can be seen in #5607

Details

Validation Enhancements

• Added validation methods (PickerCommon::ValidateViewMode, PickerCommon::ValidateStringNoEmbeddedNulls, PickerCommon::ValidateSuggestedStartLocation, and PickerCommon::ValidateSuggestedFileName) to ensure proper input values for picker properties across FileOpenPicker, FileSavePicker, and FolderPicker. These validations prevent invalid or malformed data from being set. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12]

File Type Management Refactor

• Introduced FileTypeFilterVector and FileTypeChoicesMap classes to centralize file type filtering logic with validation. These classes ensure all file type elements are validated before being added or updated. [1] [2] [3] [4]
• Refactored FileOpenPicker and FileSavePicker constructors to utilize these new classes for managing file type filters. [1] [2]

PickerLocationId Updates

• Removed obsolete entries (HomeGroup) from the PickerLocationId enumeration and reassigned explicit values to remaining entries for consistency. [1] [2]

Additional Improvements

• Updated includes in several files to ensure dependencies are properly managed and to support new functionality. [1] [2] [3]

Tests

Adding new tests:

• VerifyValidateViewMode
• VerifyValidateSuggestedStartLocation
• VerifyValidateSuggestedFileName
• VerifyFolderPicker_ValidateCommitButtonText
• VerifyFileOpenPicker_ValidateCommitButtonText
• VerifyFileSavePicker_ValidateCommitButtonText
• VerifyFolderPicker_ValidateSettingsIdentifer
• VerifyFileOpenPicker_ValidateSettingsIdentifier
• VerifyFileSavePicker_ValidateSettingsIdentifier
• VerifyValidateSingleFileTypeFilterElement
• VerifyValidateFileTypeFilter
• VerifyValidateFileTypeChoices

Also verified with existing StoragePickersTests

[DinahK-2SO]

/azp run

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).