User.GetUserAgeRangeAsync Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Recupera el intervalo de edad en el que se encuentra el usuario actual.
public:
virtual IAsyncOperation<UserAgeRange ^> ^ GetUserAgeRangeAsync() = GetUserAgeRangeAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<UserAgeRange> GetUserAgeRangeAsync();[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<UserAgeRange> GetUserAgeRangeAsync();function getUserAgeRangeAsync()Public Function GetUserAgeRangeAsync () As IAsyncOperation(Of UserAgeRange)Devoluciones
Una operación asincrónica que devuelve un UserAgeRange para el usuario actual, o null cuando el intervalo de edad es desconocido o no disponible.
- Atributos
Requisitos de Windows
| Requisitos | Description |
|---|---|
| Familia de dispositivos |
Windows 11, version 24H2 (se introdujo en la versión 10.0.26100.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (se introdujo en la versión v19.0)
|
| Características de aplicaciones |
userAccountInformation
|
Ejemplos
#include <winrt/Windows.Foundation.h>
#include <winrt/Windows.System.h>
using namespace winrt;
using namespace winrt::Windows::System;
int wmain()
{
init_apartment();
User user = User::GetDefault();
UserAgeRange range = user.GetUserAgeRangeAsync().get();
if (range)
{
int32_t lower = range.Lower();
int32_t upper = range.Upper();
// Use the inclusive age bucket.
}
else
{
// Use the app's fallback experience.
}
}
User user = User.GetDefault();
UserAgeRange range = await user.GetUserAgeRangeAsync();
if (range != null)
{
int lower = range.Lower;
int upper = range.Upper;
// Use the inclusive age bucket.
}
else
{
// Use the app's fallback experience.
}
Comentarios
UserAgeRange.Lower y UserAgeRange.Upper son límites inclusivos.
| Grupo de edad | Lower |
Upper |
|---|---|---|
| Menos de 10 | 0 | 9 |
| 10-12 | 10 | 12 |
| 13-15 | 13 | 15 |
| 16-17 | 16 | 17 |
| 18 años o más | 18 | INT32_MAX |
La operación devuelve null cuando no se conoce la edad del usuario, la característica no está disponible o las API están deshabilitadas por la directiva administrativa. Un null resultado es un resultado esperado y no debe tratarse como una edad exacta o como el intervalo de 18 o más antiguos.
- Llame a este método en el objeto User para el usuario que ejecuta el proceso actual. Use User.GetDefault para obtener ese usuario directamente.
- El paquete de la aplicación debe declarar la
userAccountInformationfuncionalidad. Un autor de llamada sin acceso o un autor de llamada mediante unUserobjeto para un usuario diferente puede recibirE_ACCESSDENIED. - Este método devuelve un cubo de edad, no la edad exacta del usuario o la fecha de nacimiento.
- En C++/WinRT, llame
.get()desde un subproceso que no sea de interfaz de usuario adecuado o useco_awaitdesde una corrutina.
Directiva administrativa
Los administradores pueden deshabilitar las API de edad de seguridad digital o configurar un grupo de edad predeterminado a través de la directiva de grupo o MDM. Cuando las API están deshabilitadas, este método devuelve null. Cuando se configura un grupo de edad predeterminado, este método devuelve el UserAgeRange que corresponde a ese grupo.