/// <summary>
/// Gets information about people authorized for an application.
/// </summary>
///
/// <remarks>
/// The returned IEnumerable iterator will access the HealthVault service
/// across the network. See <see cref="GetAuthorizedPeopleSettings"/> for applicable
/// settings.
/// </remarks>
///
/// <param name="settings">
/// The <see cref="GetAuthorizedPeopleSettings" /> object used to configure the
/// IEnumerable iterator returned by this method.
/// </param>
///
/// <returns>
/// An IEnumerable iterator of <see cref="PersonInfo"/> objects representing
/// people authorized for the application.
/// </returns>
///
/// <exception cref="HealthServiceException">
/// The HealthVault service returned an error. The retrieval can be retried from the
/// current position by calling this method again and using the last successfully
/// retrieved person Id for <see cref="GetAuthorizedPeopleSettings.StartingPersonId"/>.
/// </exception>
///
/// <exception cref="ArgumentNullException">
/// <paramref name="settings"/> is null.
/// </exception>
///
//[Obsolete("Use HealthServicePlatform.GetAuthorizedPeople() instead.")]
public IEnumerable<PersonInfo> GetAuthorizedPeople(GetAuthorizedPeopleSettings settings)
{
return HealthVaultPlatform.GetAuthorizedPeople(this, settings);
}
/// <summary>
/// Gets information about people authorized for an application.
/// </summary>
///
/// <remarks>
/// The returned IEnumerable iterator will access the HealthVault service
/// across the network. See <see cref="GetAuthorizedPeopleSettings"/> for applicable
/// settings.
/// </remarks>
///
/// <param name="connection">The connection to use to perform the operation. This connection
/// must be application-level. </param>
///
/// <param name="settings">
/// The <see cref="GetAuthorizedPeopleSettings" /> object used to configure the
/// IEnumerable iterator returned by this method.
/// </param>
///
/// <returns>
/// An IEnumerable iterator of <see cref="PersonInfo"/> objects representing
/// people authorized for the application.
/// </returns>
///
/// <exception cref="HealthServiceException">
/// The HealthVault service returned an error. The retrieval can be retried from the
/// current position by calling this method again and using the last successfully
/// retrieved person Id for <see cref="GetAuthorizedPeopleSettings.StartingPersonId"/>.
/// </exception>
///
/// <exception cref="ArgumentNullException">
/// <paramref name="settings"/> is null.
/// </exception>
///
public static IEnumerable<PersonInfo> GetAuthorizedPeople(
ApplicationConnection connection,
GetAuthorizedPeopleSettings settings)
{
return HealthVaultPlatformApplication.Current.GetAuthorizedPeople(connection, settings);
}
