DismDisableFeature – funkce

Článek
12/19/2024

Zakáže funkci v aktuálním obrázku.

Syntax

HRESULT WINAPI DismDisableFeature(
  _In_     DismSession            Session,
  _In_     PCWSTR                 FeatureName,
  _In_opt_ PCWSTR                 PackageName,
  _In_     BOOL                   RemovePayload,
  _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řidružit k obrázku pomocí DismOpenSession.

FeatureName [in]
Název funkce, kterou chcete zakázat. Pokud chcete zakázat více než jednu funkci, oddělte jednotlivé názvy funkcí středníkem.

PackageName [vstupní, volitelné]
Volitelný. Název nadřazeného balíčku, jehož je funkce součástí. Pokud není zadán žádný balíček, použije se výchozí balíček Windows Foundation.

RemovePayload [in]
Tento parametr není podporován od verze WindowsWindows 8.1 a Windows Server 2012 R2.

Windows 8 a Windows Server 2012:

Logická hodnota určující, jestli se mají odebrat soubory potřebné k povolení funkce.

Hodnota	Popis
PRAVDIVÝ	Soubory byly odstraněny.
FALEŠNÝ	Soubory se neodeberou.

cancelEvent [in, optional]
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řijato CancelEvent a operace se zruší, 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, volitelné]
Volitelný. Ukazatel na klientem definovaný DismProgressCallback.

UserData [in, optional]
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ĚCHU_VYŽADUJE_RESTART	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.

Příklad

HRESULT hr = S_OK;
hr = DismDisableFeature(Session, "WindowsMediaPlayer", NULL, 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
DLL	DismAPI.dll

Viz také

PovolitFunkciDism

DismGetFeatures

DismGetFeatureInfo

Sdílet prostřednictvím