IToolsContextQueriesAPI::GetCurrentSelectionState

Collect up current-selection information for the current scene state (ie what is selected in Editor, etc)