Funzione DismRemovePackage
Rimuove un pacchetto da un'immagine.
Sintassi
HRESULT WINAPI DismRemovePackage(
_In_ DismSession Session,
_In_ PCWSTR Identifier,
_In_ DismPackageIdentifier PackageIdentifier,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Parametri
Sessione [in]
DismSession valido. L'oggetto DismSession deve essere associato a un'immagine. È possibile associare una sessione a un'immagine usando DismOpenSession.
Identificatore [in]
Percorso assoluto di un file .cab o del nome del pacchetto, a seconda del valore del parametro PackageIdentifier .
PackageIdentifier [in]
Facoltativa. Valore di enumerazione DismPackageIdentifier valido.
| Valore | Descrizione |
|---|---|
| PackageName | Usare questo valore quando si vuole specificare un pacchetto usando il nome del pacchetto. |
| PackagePath | Usare questo valore quando si vuole specificare un pacchetto usando un percorso assoluto di un file di .cab. |
| PackageNone | Non un valore valido per questa funzione. |
CancelEvent [in, facoltativo]
Facoltativa. È possibile impostare CancelEvent per questa funzione per annullare l'operazione in corso quando viene segnalato dal client. Se cancelEvent viene ricevuto in una fase quando l'operazione non può essere annullata, l'operazione continuerà e restituirà un codice di esito positivo. Se cancelEvent viene ricevuto e l'operazione viene annullata, lo stato dell'immagine è sconosciuto. È necessario verificare lo stato dell'immagine prima di continuare o ignorare le modifiche e ricominciare.
Stato [in, facoltativo]
Facoltativa. Puntatore a un client definito da DismProgressCallback.
UserData [in, facoltativo]
Facoltativa. Dati personalizzati definiti dall'utente.
Valore restituito
Restituisce S_OK sull'esito positivo.
Commenti
La funzione DismRemovePackage non supporta i file msu.
Esempio
HRESULT hr = S_OK;
hr = DismRemovePackage(Session, "C:\\packages\\test.CAB", PackagePath, NULL, NULL, NULL);
Requisiti
| Requisito | Descrizione |
|---|---|
| Piattaforme host supportate | L'API DISM può essere usata in qualsiasi sistema operativo supportato da Windows Assessment and Deployment Kit (Windows ADK). Per altre informazioni, vedere Informazioni di riferimento tecnico su Windows ADK. |
| Piattaforme di immagini supportate | Windows 7, Windows Server 2008 R2, Windows PE 3.0, Windows 8, Windows Server 2012, Windows Preinstallation Environment (Windows PE) 4.0, Windows 8.1, Windows Server 2012 R2, Windows 10, Windows Server 2016 |
| Client minimo supportato | Windows 7 [solo app desktop] |
| Server minimo supportato | Windows Server 2008 R2 [solo app desktop] |
| Intestazione | DismAPI.h |
| Libreria | DismAPI.lib |
| DLL | DismAPI.dll |