Funkce DismRemovePackage

Článek
12/18/2024

Odebere balíček z obrazu.

Syntax

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

Parametry

Relace [in]
Platná DismSession. DismSession musí být přidružen k obrázku. Relaci můžete přiřadit k obrazu pomocí DismOpenSession.

identifikátor [in]
Buď absolutní cesta k souboru .cab nebo název balíčku, v závislosti na hodnotě parametru PackageIdentifier.

PackageIdentifier [in]
Volitelný. Platná hodnota výčtu DismPackageIdentifier.

Hodnota	Popis
PackageName	Tuto hodnotu použijte, pokud chcete zadat balíček pomocí názvu balíčku.
PackagePath	Tuto hodnotu použijte, pokud chcete zadat balíček pomocí absolutní cesty k souboru .cab.
PackageNone	Neplatná hodnota pro tuto funkci.

CancelEvent [in, 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 obrazu 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 klientem definovaný DismProgressCallback.

UserData [in, volitelné]
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
(Bude-li relevantní překlad nebo vysvětlení termínu ERROR_SUCCESS_REBOOT_REQUIRED, vložte sem odpovídající českou variantu) (HRESULT)ERROR_SUCCESS_REBOOT_REQUIRED	Pokud je relace online, je potřeba počítač restartovat.
DISMAPI_S_RELOAD_IMAGE_SESSION_REQUIRED	relace je potřeba znovu načíst.

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

Poznámky

Funkce DismRemovePackage nepodporuje soubory .msu.

Příklad

HRESULT hr = S_OK;
hr = DismRemovePackage(Session, "C:\\packages\\test.CAB", PackagePath, 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
DLL	DismAPI.dll

Viz také

DismAddPackage

DismGetPackages

DismRemoveDriver

DismDisableFeature

Sdílet prostřednictvím