DismAddPackage – funkce

Článek
12/20/2024

Přidá do image Windows jeden soubor .cab nebo .msu.

Syntax

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
);

Parametry

relace [v]
Jde o platná DismSession. DismSession musí být přidružen k obrázku. Relaci můžete přidružit k obrázku pomocí DismOpenSession.

PackagePath [in]
Relativní nebo absolutní cesta k přidanému souboru .cab nebo .msu nebo ke složce obsahující rozbalené soubory jednoho souboru .cab.

IgnoreCheck [in]
Logická hodnota, která určuje, jestli se mají ignorovat kontroly interní použitelnosti provedené při přidání balíčku.

Hodnota	Popis
PRAVDIVÝ	Ignorujte interní kontroly použitelnosti.
FALEŠNÝ	Neignorujte kontroly interní použitelnosti.

PreventPending [in]
Logická hodnota určující, jestli se má přidat balíček, pokud má probíhající online akce.

Hodnota	Popis
PRAVDIVÝ	Zabrání instalaci balíčku, který obsahuje čekající online akce.
NEPRAVDA	Povolte instalaci balíčku, který má čekající online akce.

cancelEvent [vstup, volitelné]
Volitelný. Můžete nastavit CancelEvent pro tuto funkci, aby se operace zrušila, když je klient signalizoval. Pokud cancelEvent obdržíte ve fázi, kdy operaci nelze zrušit, operace bude pokračovat a vrátit kód úspěchu. Pokud je přijat CancelEvent a operace je zrušena, stav obrázku je neznámý. Než budete pokračovat, měli byste ověřit stav obrazu, nebo zahodit změny a začít znovu.

pokrok [in, optional]
Volitelný. Ukazatel na DismProgressCallbackdefinovaný klientem.

UživatelskáData [vstup, nepovinné]
Volitelný. Uživatelsky definovaná vlastní data

Návratová hodnota

Pokud je funkce úspěšná, návratová hodnota je S_OK. Funkce může také vrátit jednu z následujících hodnot, pokud bude úspěšná:

Návratový kód	Popis
(HRESULT)CHYBA_ÚSPĚCH_POŽADOVÁN_RESTART	Je potřeba restartovat počítač, pokud je relace online.
DISMAPI_S_SEANCE_NAČTENÍ_OBRAZU_VYŽADOVÁNA	relace je potřeba znovu načíst.

Pokud funkce selže, návratová hodnota je chybová hodnota HRESULT.

Poznámky

Do online obrázku je možné přidat pouze .cab soubory. Do offline obrázku je možné přidat soubory .cab nebo .msu.

Tato funkce vrátí speciální kód chyby, pokud balíček není použitelný. Pomocí DismGetPackageInfo můžete určit, zda se balíček vztahuje na cílovou image.

Příklad

HRESULT hr = S_OK;
hr = DismAddPackage(Session, "C:\\packages\\calc.cab", FALSE, FALSE, NULL, NULL, NULL);

Požadavky

Požadavek	Popis
Podporované hostitelské platformy	Rozhraní DISM API lze použít v jakémkoli operačním systému podporovaném sadou Windows Assessment and Deployment Kit (Windows ADK). Další informace naleznete v Windows ADK Technical Reference.
Podporované platformy imagí	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
Minimální podporovaný klient	Windows 7 [pouze desktopové aplikace]
Minimální podporovaný server	Windows Server 2008 R2 [jenom desktopové aplikace]
Záhlaví	DismAPI.h
Knihovna	DismAPI.lib
knihovna DLL	DismAPI.dll