DismRemovePackage functie
Hiermee verwijdert u een pakket uit een afbeelding.
Syntaxis
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
);
Parameters
Sessie [in]
Een geldige DismSession. De DismSession moet zijn gekoppeld aan een afbeelding. U kunt een sessie koppelen aan een installatiekopie met behulp van de DismOpenSession.
id [in]
Een absoluut pad naar een .cab bestand of de pakketnaam, afhankelijk van de PackageIdentifier parameterwaarde.
PackageIdentifier [in]
Facultatief. Een geldige DismPackageIdentifier opsommingswaarde.
| Waarde | Beschrijving |
|---|---|
| PackageName | Gebruik deze waarde als u een pakket wilt opgeven met behulp van de pakketnaam. |
| PackagePath | Gebruik deze waarde als u een pakket wilt opgeven met behulp van een absoluut pad naar een .cab bestand. |
| PakketGeen- | Geen geldige waarde voor deze functie. |
CancelEvent [binnen, optioneel]
Facultatief. U kunt een CancelEvent instellen voor deze functie om de actieve bewerking te annuleren wanneer deze door de client wordt gesignaleerd. Als de CancelEvent- wordt ontvangen in een fase waarin de bewerking niet kan worden geannuleerd, wordt de bewerking voortgezet en wordt een geslaagde code geretourneerd. Als de CancelEvent- wordt ontvangen en de bewerking wordt geannuleerd, is de status van de afbeelding onbekend. Controleer de status van de afbeelding voordat u doorgaat of negeer de wijzigingen en start opnieuw.
Voortgang [in, optioneel]
Facultatief. Een aanwijzer naar een door de klant gedefinieerde DismProgressCallback.
UserData [in, optioneel]
Facultatief. Door de gebruiker gedefinieerde aangepaste gegevens.
Retourwaarde
Als de functie slaagt, wordt de retourwaarde S_OK. De functie kan ook een van de volgende waarden retourneren wanneer deze slaagt:
| Retourcode | Beschrijving |
|---|---|
|
Als de Sessie online is, moet de computer opnieuw worden opgestart. |
|
De Sessie moet opnieuw worden geladen. |
Als de functie mislukt, is de retourwaarde een HRESULT-foutwaarde.
Opmerkingen
De functie DismRemovePackage biedt geen ondersteuning voor MSU-bestanden.
Voorbeeld
HRESULT hr = S_OK;
hr = DismRemovePackage(Session, "C:\\packages\\test.CAB", PackagePath, NULL, NULL, NULL);
Eisen
| Eis | Beschrijving |
|---|---|
| Ondersteunde hostplatforms | DISM-API kan worden gebruikt op elk besturingssysteem dat wordt ondersteund door de Windows Assessment and Deployment Kit (Windows ADK). Zie de Windows ADK Technical Referencevoor meer informatie. |
| Ondersteunde afbeeldingsplatforms | 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 |
| Minimaal ondersteunde client | Windows 7 [alleen desktop-apps] |
| Minimaal ondersteunde server | Windows Server 2008 R2 [alleen desktop-apps] |
| Koptekst | DismAPI.h |
| Bibliotheek | DismAPI.lib |
| DLL | DismAPI.dll |