Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Importante
La aplicación Contactos de Windows finalizó el soporte técnico el 31 de diciembre de 2024 y se ha quitado de Windows 11 versión 24H2 y posteriores. El esquema de URI de ms-people: documentado en esta página ya no funciona en instalaciones modernas de Windows 11. Para la administración de contactos en las aplicaciones, consulte el nuevo Outlook para Windows.
Esta documentación se mantiene con fines de referencia para los desarrolladores que trabajan con versiones anteriores de Windows.
En este tema se describe el esquema ms-people: URI. Tu WinUI, UWP y otras aplicaciones de escritorio de Windows pueden usar este esquema de URI para iniciar la aplicación Contactos para acciones específicas.
ms-people: referencia del esquema de URI
| Results | Esquema de URI |
|---|---|
| Permite que otras aplicaciones inicien la página principal de la aplicación Personas. | ms-people: |
| Permite que otras aplicaciones abran la página de configuración de la aplicación Personas. | ms-people:settings |
| Permite que otras aplicaciones proporcionen una cadena de búsqueda que iniciará la aplicación de Personas con la página de resultados de la búsqueda.
Los parámetros distinguen mayúsculas de minúsculas. Si no escribe correctamente la sintaxis o falta el valor de la cadena de búsqueda, el comportamiento predeterminado es devolver una lista completa de contactos sin ningún filtrado. |
ms-people:search?SearchString=contactsearchinfo |
| Se inicia en una tarjeta de contacto existente, si se encuentra el contacto. O bien, se inicia en una tarjeta de contacto temporal, si no se encuentra ningún contacto. Si no se proporciona ningún parámetro de entrada, iniciaremos la aplicación Contactos con una lista de contactos.
Los parámetros son sensibles a mayúsculas y minúsculas. El orden de los parámetros no importa. Si hay más de una coincidencia, devolveremos la primera coincidencia del contacto. |
ms-people:viewcontact? ContactId=contactid&AggregatedId=aggid&PhoneNumber= phonenum&Email=email&ContactName=name&Contact=contactobj |
| Se abre una página para guardar contactos dentro de la aplicación Personas para almacenar el contacto especificado con el número de teléfono o la dirección de correo electrónico suministrados.
Los parámetros son sensibles a mayúsculas y minúsculas. El orden de los parámetros no importa. |
ms-people:savetocontact?PhoneNumber=phonenum&Email=email&ContactName=name |
| Se lanza la página para agregar un nuevo contacto dentro de la aplicación Personas para guardar el contacto dado.
Utiliza LaunchUriForResultsAsync para abrir la página para guardar un nuevo contacto. El uso de LaunchUriAsync solo iniciará la página Principal de la aplicación People. Los parámetros distinguen mayúsculas de minúsculas. El orden de los parámetros no importa. Puede usar cualquier combinación de parámetros admitidos. |
ms-people:savecontacttask?PhoneNumber=phonenum&Email=email&ContactName=name |
ms-people:search: referencia de los parámetros
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| SearchString | Opcional. Cadena de búsqueda de la información de búsqueda de contactos. Número de teléfono o nombre de contacto. |
ms-people:search?SearchString=Smith |
ms-people:viewcontact: referencia de parámetros
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| ID de contacto | Opcional. Id. de contacto del contacto. |
ms-people:viewcontact?ContactId={ContactId} |
| NúmeroDeTeléfono | Opcional. Número de teléfono del contacto. |
ms-people:viewcontact?PhoneNumber=%2014257069326 |
| Correo electrónico | Opcional. Correo electrónico del contacto. |
ms-people:viewcontact? Email= |
| ContactName | Opcional. Nombre del contacto. |
ms-people:viewcontact?ContactName=John%20%Smith |
| Contacto | Opcional. Objeto de contacto. |
ms-people:viewcontact?Contact={Serialized Contact} |
ms-people:savetocontact: referencia de parámetros
| Parámetro | Descripción | Ejemplo |
|---|---|---|
| NúmeroDeTeléfono | Opcional. Número de teléfono del contacto. |
ms-people:savetocontact?PhoneNumber=%2014257069326 |
| Correo electrónico | Opcional. Correo electrónico del contacto. |
ms-people:savetocontact? Email= |
| ContactName | Opcional. Nombre del contacto. |
ms-gente:guardarencontacto?CorreoElectrónico=&NombreContacto= John%20%Smith |
ms-people:savecontacttask: referencia de parámetros
| Parámetro | Descripción |
|---|---|
| Compañía | Opcional. Nombre de la compañía del contacto. |
| FirstName | Opcional. Nombre del contacto. |
| DirecciónDeCasaCiudad | Opcional. Ciudad de la dirección del domicilio. |
| PaísDeDomicilio | Opcional. País de la dirección principal. |
| EstadoDomicilio | Opcional. Estado de la dirección de domicilio. |
| DirecciónDomiciliariaCalle | Opcional. Calle de la dirección principal. |
| CódigoPostalDeLaDirecciónDoméstica | Opcional. Código postal de la dirección principal. |
| Teléfono de casa | Opcional. Teléfono de casa del contacto. |
| JobTitle | Opcional. Título del puesto del contacto. |
| LastName | Opcional. Apellidos del contacto. |
| Segundo nombre | Opcional. Nombre intermedio del contacto. |
| Teléfono móvil | Opcional. Número de teléfono móvil del contacto. |
| Apodo | Opcional. Apodo del contacto. |
| Notas | Opcional. Notas sobre el contacto. |
| OtherEmail | Opcional. Otro correo electrónico del contacto. |
| CorreoElectrónicoPersonal | Opcional. Correo electrónico personal del contacto. |
| Posnombre | Opcional. Sufijo del contacto. |
| Título | Opcional. Título del contacto. |
| Sitio web | Opcional. Sitio web del contacto. |
| CiudadDeDirecciónDeTrabajo | Opcional. Ciudad de la dirección de trabajo. |
| País de Dirección de Trabajo | Opcional. País de la dirección de trabajo. |
| WorkAddressState | Opcional. Estado del informe sobre el trabajo. |
| WorkAddressStreet | Opcional. Calle de la dirección del trabajo. |
| WorkAddressZipCode | Opcional. Código postal de la dirección de trabajo. |
| CorreoElectrónicoDeTrabajo | Opcional. Correo electrónico de trabajo del contacto. |
| Teléfono de Trabajo | Opcional. Número de teléfono profesional del contacto. |
Contenido relacionado
Lanzar una aplicación de Windows con un URI
Iniciar la aplicación predeterminada para un URI
Colaborar con nosotros en GitHub
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
