這很重要
Windows People 應用程式於 2024 年 12 月 31 日停止支援，並已從 Windows 11 24H2 及更新版本中移除。 本頁所記載的 ms-people: URI 方案已無法在現代 Windows 11 安裝中運作。 關於應用程式中的聯絡人管理，請參閱 新的 Outlook for Windows。
本文件僅供使用舊版 Windows 的開發者參考使用。
本主題介紹 ms-people： URI 方案。 你的 WinUI 和其他 Windows 桌面應用程式可以使用這個 URI 方案來啟動 People 應用程式執行特定動作。
ms-people： URI 配置參考
| 結果 | URI 架構 |
|---|---|
| 允許其他應用程式啟動 [人員] 應用程式主頁。 | ms-people： |
| 允許其他應用程式啟動 [人員應用程式設定] 頁面。 | ms-people：settings |
| 允許其他應用程式提供搜尋字串，將啟動 People 應用程式並顯示搜尋結果頁面。
參數會區分大小寫。 如果您未正確輸入語法，或遺漏搜尋字串值，預設行為是傳回聯繫人的完整清單，而不需要任何篩選。 |
MS-people：搜尋？SearchString=<contactsearchinfo> |
| 如果找到連絡人，就會開啟現有的連絡人卡片。 或者，如果找不到聯繫人，則會開啟暫時聯繫人卡片。 如果未提供任何輸入參數，我們會使用聯繫人清單啟動人員應用程式。
參數會區分大小寫。 參數的順序並不重要。 如果有一個以上的相符項目，我們會返回聯繫人的第一個相符項目。 |
MS-People：查看聯絡人？ContactId=<contactid>&AggregatedId=<aggid>&PhoneNumber=<phonenum>&Email=<email>&ContactName=<name>&Contact=<contactobj> |
| 啟動至 [人員] 應用程式內的 [儲存聯繫人] 頁面，以使用提供的電話號碼或電子郵件位址儲存指定的聯繫人。
參數會區分大小寫。 參數的順序並不重要。 |
MS-People：Saveto Contact？電話號碼= <電話號碼> & 電子郵件=<電子郵件> & 聯絡人名稱=<名稱> |
| 啟動至 [人員] 應用程式內的 [新增聯繫人] 頁面，以儲存指定的聯繫人。
使用 LaunchUriForResultsAsync 開啟「儲存新聯絡人」頁面。 使用 LaunchUriAsync 只會啟動 People 應用程式的主頁。 參數會區分大小寫。 參數的順序並不重要。 您可以使用任何支援參數的組合。 |
ms-people：savecontacttask？電話號碼= <電話號碼> & 電子郵件=<電子郵件> & 聯絡人名稱=<名稱> |
ms-people：search：參數參考
| 參數 | 描述 | 例 |
|---|---|---|
| 搜尋字串 | 自選。 聯絡人搜尋資訊的搜尋字串。 電話號碼或聯繫人名稱。 |
ms-people：search？SearchString=Smith |
ms-people：viewcontact： 參數參考
| 參數 | 描述 | 例 |
|---|---|---|
| 聯絡人識別碼 | 自選。 聯絡人的ID。 |
ms-people：viewcontact？ContactId={ContactId} |
| 電話號碼 | 自選。 聯繫人的電話號碼。 |
ms-people：viewcontact？PhoneNumber=%2014257069326 |
| 電子郵件 | 自選。 聯繫人的電子郵件。 |
MS-People：查看聯絡人？電子郵件=johnsmith@contsco.com |
| ContactName | 自選。 聯繫人的名稱。 |
ms-people：viewcontact？ContactName=John%20%Smith |
| 連絡人 | 自選。 聯絡對象。 |
ms-people：viewcontact？Contact={Serialized Contact} |
ms-people：savetocontact： 參數參考
| 參數 | 描述 | 例 |
|---|---|---|
| 電話號碼 | 自選。 聯繫人的電話號碼。 |
ms-people：savetocontact？PhoneNumber=%2014257069326 |
| 電子郵件 | 自選。 聯繫人的電子郵件。 |
ms-people:savetoContact?電子郵件=johnsmith@contsco.com |
| ContactName | 自選。 聯繫人的名稱。 |
ms-people：保存到聯絡人？電子郵件= |
ms-people：savecontacttask：參數參考
| 參數 | 描述 |
|---|---|
| 公司 | 自選。 聯繫人的公司名稱。 |
| FirstName | 自選。 連絡人的名字。 |
| 住家地址城市 | 自選。 住家位址的城市。 |
| HomeAddressCountry | 自選。 住家地址的國家/地區。 |
| HomeAddressState | 自選。 住家地址的狀態。 |
| HomeAddressStreet | 自選。 住址的街道。 |
| 住家地址郵遞區號 | 自選。 住家地址的郵遞區編碼。 |
| 家庭電話 | 自選。 聯繫人的家庭電話。 |
| JobTitle | 自選。 聯繫人的職稱。 |
| LastName | 自選。 聯繫人的姓氏。 |
| 中間名 | 自選。 聯繫人的中間名。 |
| 手機 | 自選。 聯繫人的行動電話號碼。 |
| 綽號 | 自選。 聯繫人的昵稱。 |
| 注意事項 | 自選。 聯繫人的相關注意事項。 |
| 其他電子郵件 | 自選。 聯繫人的其他電子郵件。 |
| 個人電子郵件 | 自選。 聯繫人的個人電子郵件。 |
| 後置詞 | 自選。 聯繫人的後綴。 |
| 標題 | 自選。 聯繫人的標題。 |
| 網站 | 自選。 聯繫人的網站。 |
| 工作地址城市 | 自選。 工作位址的城市。 |
| 工作地址國家 | 自選。 工作地址的國家/地區。 |
| WorkAddressState | 自選。 工作地址的狀態。 |
| 工作位址 | 自選。 工作位址的街道。 |
| 工作地址郵遞區號 | 自選。 工作地址的郵遞區編碼。 |
| 工作電子郵件 | 自選。 連絡人的工作電子郵件。 |
| 工作電話 | 自選。 聯繫人的工作電話號碼。 |
