Functie DismAddPackage

Artikel
12/18/2024

Voegt een enkel .cab- of .msu-bestand toe aan een Windows-image.

Syntaxis

HRESULT WINAPI DismAddPackage(
  _In_     DismSession            Session,
  _In_     PCWSTR                 PackagePath,
  _In_     BOOL                   IgnoreCheck,
  _In_     BOOL                   PreventPending,
  _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 afbeelding met behulp van de DismOpenSession.

PackagePath [in]
Een relatief of absoluut pad naar het .cab- of MSU-bestand dat wordt toegevoegd, of een map met de uitgevouwen bestanden van één .cab bestand.

IgnoreCheck [in]
Een Booleaanse waarde om op te geven of de interne toepasbaarheidscontroles moeten worden genegeerd die worden uitgevoerd wanneer een pakket wordt toegevoegd.

Waarde	Beschrijving
WAAR	Negeer de interne toepasselijkheidscontroles.
VALS	Negeer de interne toepasselijkheidscontroles niet.

PreventPending [in]
Een booleaanse waarde om aan te geven of een pakket moet worden toegevoegd wanneer er nog online acties zijn.

Waarde	Beschrijving
WAAR	Voorkom de installatie van een pakket dat onlineacties in behandeling heeft.
ONWAAR	Hiermee staat u de installatie toe van een pakket dat hangende online acties heeft.

CancelEvent [in, 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 client 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
(HRESULT)-ERROR_SUCCESS_REBOOT_REQUIRED	Als de Sessie online is, moet de computer opnieuw worden opgestart.
DISMAPI_S_RELOAD_IMAGE_SESSION_REQUIRED	De sessie moet opnieuw worden geladen.

Als de functie mislukt, is de retourwaarde een HRESULT-foutwaarde.

Opmerkingen

Alleen .cab bestanden kunnen worden toegevoegd aan een onlineafbeelding. U kunt .cab- of MSU-bestanden toevoegen aan een offlineafbeelding.

Deze functie retourneert een speciale foutcode als het pakket niet van toepassing is. U kunt de DismGetPackageInfo gebruiken om te bepalen of een pakket van toepassing is op de doelafbeelding.

Voorbeeld

HRESULT hr = S_OK;
hr = DismAddPackage(Session, "C:\\packages\\calc.cab", FALSE, FALSE, 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