PackageManager.RemovePackageAsync(String) | removePackageAsync(String) Method

Quita un paquete para el usuario actual de forma asincrónica y recibe mensajes de progreso y estado de la operación de eliminación. Los paquetes de dependencia también se quitan para el usuario si no hay ningún otro paquete instalado para el usuario que dependa de ellos.

Sintaxis


packageManager.removePackageAsync(packageFullName).done( /* Su éxito y controladores de errores */ );

Parámetros

packageFullName

Tipo: String [JavaScript] | System.String [.NET] | Platform::String [C++]

Una representación de cadena de la identidad del paquete para identificar el paquete que se va a quitar.

Valor devuelto

Tipo: IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress>

El estado de la solicitud de implementación. DeploymentResult contiene el valor devuelto final de la operación de implementación, una vez completada. La estructura DeploymentProgress se puede usar para obtener el porcentaje de finalización durante toda la operación de implementación.

Comentarios

Esta solicitud no se puede cancelar. El nombre completo del paquete es un formulario alternativo de la identidad del paquete que es más corta y es adecuada para asignar nombres a objetos como archivos y directorios. Una identidad de paquete se representa mediante el elemento Identity del manifiesto del paquete. Cuando se quita un paquete se quita del usuario actual, lo que significa que la carga del paquete sigue existiendo si otros usuarios han instalado el paquete, pero no será accesible para el usuario actual. Si no hay ningún otro usuario con el paquete especificado instalado, la carga se quitará del directorio %ProgramFiles%\WindowsApps. Cualquier aplicación asociada al paquete que se está quitando se apagará automáticamente como parte de la eliminación del paquete.

Ejemplos

Llame al método RemovePackageAsync(String) para desinstalar el paquete de la aplicación. Observe que el nombre completo del paquete en packageFullName procede de un argumento de la línea de comandos.

RemovePackageAsync(String) devuelve un objeto que se puede utilizar para administrar la operación asincrónica. Utilice la propiedad Completed para establecer el delegado. Compruebe la propiedad Status para determinar el estado de la operación de implementación. Si el estado es Error, el ejemplo llama al método GetResults para obtener información adicional del error.



using Windows.Foundation;
using Windows.Management.Deployment;

[STAThread]
public static int Main(string[] args)
{
    string inputPackageFullName = args[0];
    int returnValue = 0;

    PackageManager packageManager = new Windows.Management.Deployment.PackageManager();

    IAsyncOperationWithProgress<DeploymentResult, DeploymentProgress> deploymentOperation = 
        packageManager.RemovePackageAsync(inputPackageFullName);
    // This event is signaled when the operation completes
    ManualResetEvent opCompletedEvent = new ManualResetEvent(false); 

    // Define the delegate using a statement lambda
    deploymentOperation.Completed = (depProgress, status) => { opCompletedEvent.Set(); };

    // Wait until the operation completes
    opCompletedEvent.WaitOne();

    // Check the status of the operation
    if (deploymentOperation.Status == AsyncStatus.Error)
    {
        DeploymentResult deploymentResult = deploymentOperation.GetResults();
        Console.WriteLine("Error code: {0}", deploymentOperation.ErrorCode);
        Console.WriteLine("Error text: {0}", deploymentResult.ErrorText);
        returnValue = 1;
    }
    else if (deploymentOperation.Status == AsyncStatus.Canceled)
    {
        Console.WriteLine("Removal canceled");
    }
    else if (deploymentOperation.Status == AsyncStatus.Completed)
    {
        Console.WriteLine("Removal succeeded");
    }
    else
    {
        returnValue = 1;
        Console.WriteLine("Removal status unknown");
    }

    return returnValue;
}

Requisitos

Cliente mínimo admitido

Windows 8

Servidor mínimo admitido

Windows Server 2012

Espacio de nombres

Windows.Management.Deployment
Windows::Management::Deployment [C++]

Metadatos

Windows.winmd

Vea también

PackageManager
RemovePackageAsync(String, RemovalOptions)

 

 

Mostrar:
© 2014 Microsoft