DismAddCapability funkce
Přidá do obrázku funkci.
Syntaxe
HRESULT WINAPI DismAddCapability(
_In_ DismSession Session,
_In_ PCWSTR Name,
_In_ BOOL LimitAccess,
_In_ PCWSTR* SourcePaths,
_In_opt_ UINT SourcePathCount,
_In_opt_ HANDLE CancelEvent,
_In_opt_ DISM_PROGRESS_CALLBACK Progress,
_In_opt_ PVOID UserData
);
Parametry
sezení
Platná DismSession. DismSession musí být přidružen k obrázku. Relaci můžete přidružit k obrázku pomocí DismOpenSession.
název [in]
Název přidané funkce.
LimitAccess [v]
Příznak označuje, zda by měla být služba WU/WSUS kontaktována jako zdrojové umístění pro stažení užitečného zatížení funkčního prvku. Pokud existuje datová část schopnosti, kterou chcete přidat, bude příznak ignorován.
SourcePaths [in]
Seznam zdrojových umístění. Funkce vyhledá odebrané soubory datové části z umístění zadaných ve zdrojových cestách, a pokud nejsou nalezeny, pokračuje v hledání kontaktováním WU/WSUS v závislosti na parametru LimitAccess.
SourcePathCount [in, volitelné]
Počet položek ve zdrojovýchpathech.
CancelEvent [in, optional]
Jedná se o popisovač události pro zrušení.
pokrok [v, nepovinné]
Ukazatel na funkci zpětného volání definovanou klientem pro hlášení průběhu.
UserData [v, volitelné]
Uživatelsky definovaná vlastní data Toto bude předáno zpět uživateli prostřednictvím zpětného volání.
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 |
|---|---|
|
Pokud je relace online, je potřeba počítač restartovat. |
|
relace je potřeba znovu načíst. |
Pokud funkce selže, návratová hodnota je chybová hodnota HRESULT.
Poznámky
Pomocí této funkce můžete přidat funkci.
Příklad
HRESULT hr = S_OK;
hr = DismAddCapability(Session, L“Language.Basic~~~en-US~0.0.1.0”, TRUE, NULL, 0, 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 10, Windows Server 2016 |
| Minimální podporovaný klient | Windows 10 [pouze desktopové aplikace] |
| Minimální podporovaný server | Windows Server 2016 [jenom desktopové aplikace] |
| Záhlaví | DismAPI.h |
| Knihovna | DismAPI.lib |
| DLL | DismAPI.dll |