[C++][Parquet] Deprecate `Status` versions of `parquet:arrow::FileReader::GetRecordBatchReader()`

[kou]

Describe the enhancement requested

The unique_ptr versions of parquet:arrow::FileReader::GetRecordBatchReader() already added the Result version, deprecated Status versions and removed deprecated Status versions.

We should do this for shared_ptr versions too.

We can reuse the Result<unique_ptr> versions for shared_ptr. So we can deprecate existing Status versions.

Component(s)

C++, Parquet

[Ziy1-Tan]

take

[kou]

Issue resolved by pull request 46932
#46932