Did Yoosuf (peace be upon him) marry the wife of al-‘Azeez in the end?

There is no report in the Holy Qur’aan or the Sunnah of the
Prophet (blessings and peace of Allah be upon him) to prove or disprove
that Yoosuf (peace be upon him) married the wife of al-‘Azeez, whose name
was said by some to be Ra‘eel and by others to be Zulaykha; al-Haafiz Ibn
Katheer suggested that Zulaykha was her title. 

There is a report about Yoosuf (peace be upon him) marrying
Ra‘eel that was narrated from a well-known imam of seerah and history,
Muhammad ibn Ishaaq (may Allah have mercy on him) who said: 

With regard to Yoosuf saying to the King,
“Set me over the store‑houses of the land; I will indeed
guard them with full knowledge” [Yoosuf 12:55],
the king said: I will do that. So he appointed him instead of Itfeer and
dismissed Itfeer from his post. Allah says: “Thus did We give full
authority to Yoosuf (Joseph) in the land, to take possession therein, when
or where he likes…” [Yoosuf 12:56]. 

He said: It was mentioned to me – and Allah knows best – that
Itfeer died during those nights and that the King al-Rayyaan ibn al-Waleed
gave Itfeer’s wife, Ra‘eel, to Yoosuf in marriage, and when she entered upon
him he said: Is this not better than what you wanted? And they claimed that
she said: O Siddeeq, do not blame me, for I was a woman who was, as you see,
beautiful and enjoying a life of luxury, and my husband could not have
intimate relations with women, and you are as Allah made you, very handsome,
and I could not help myself. 

They claimed that he found her a virgin and he had
intercourse with her and she bore him two sons: Afra’eem ibn Yoosuf and
Maysha ibn Yoosuf. The son of Afra’eem was Noon, the father of Yoosha‘ ibn
Noon, and Rahmah the wife of Ayyoob (peace be upon him). End quote. 

Narrated by Ibn Abi Haatim in al-Tafseer, 7/2161;
al-Tabari in Jaami‘ al-Bayaan, 16/151. 

A similar report was narrated from Zayd ibn Aslam, the great
Taabi‘i, and from Wahb ibn Munabbih, from the Israa’eeliyyaat
(reports from Jewish sources). 

That was also narrated by al-Suyooti in al-Durr
al-Manthoor, 4/553 

Ibn al-Qayyim (may Allah have mercy on him) said: 

Chapter 27: One who gives up his beloved to avoid a haraam
relationship and then was enabled to be with his beloved in a halaal way, or
Allah compensated him with some one better, as Yoosuf al-Siddeeq avoided the
wife of al-‘Azeez for the sake of Allah, and chose prison over immoral
action, and Allah compensated him by giving him full authority in the land
to take possession therein when or where he wanted, and the woman came to
him humbly asking for a halaal relationship, so he married her and when he
entered upon her he said: This is better than what you wanted. 

Think about how Allah, may He be glorified and exalted,
rewarded him for the hardship of prison and gave him full authority in the
land to take possession therein when or where he wanted, and subdued for him
the wife of al-‘Azeez, and she and the other women attested to his
innocence. This is what Allah ordained for His slaves in the past and at
present until the Day of Resurrection. 

End quote from Rawdat al-Muhibbeen, p. 445 

This does not mean that this story is definitively true;
rather it seems that it was taken from the People of the Book, and we have
been commanded not to believe them and not to disbelieve them either. The
Prophet (blessings and peace of Allah be upon him) said: “Do not believe the
People of the Book and do not disbelieve them. Say: We believe in that which
has been revealed to us and revealed to you, our God and your God is One,
and we submit to Him.” Narrated by al-Bukhaari, 4485; classed as saheeh by
al-Albaani in Silsilat al-Ahaadeeth al-Saheehah, 422 

And Allah knows best.