De functie DismEnableFeature
Hiermee schakelt u een functie in een afbeelding in. Functies worden geïdentificeerd door een naam en kunnen eventueel aan een pakket worden gekoppeld.
Syntaxis
HRESULT WINAPI DismEnableFeature(
_In_ DismSession Session,
_In_ PCWSTR FeatureName,
_In_opt_ PCWSTR Identifier,
_In_opt_ DismPackageIdentifier PackageIdentifier,
_In_ BOOL LimitAccess,
_In_opt_ PCWSTR *SourcePaths,
_In_opt_ UINT SourcePathCount,
_In_ BOOL EnableAll,
_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 met een afbeelding koppelen door gebruik te maken van de DismOpenSession.
FeatureName [in]
De naam van de functie die wordt ingeschakeld. Als u meer dan één functie wilt inschakelen, scheidt u elke functienaam met een puntkomma.
id [in, optioneel]
Facultatief. Een absoluut pad naar een .cab-bestand of de pakketnaam voor het bovenliggende pakket van de functie die moet worden ingeschakeld.
PackageIdentifier [in, optioneel]
Facultatief. Een geldige DismPackageIdentifier opsommingswaarde.
DismPackageName- moet worden gebruikt wanneer de parameter id verwijst naar een pakketnaam en DismPackagePath- moet worden gebruikt wanneer id verwijst naar het absolute pad van een .cab bestand. Als het identificatie- veld niet NULL-is, moet u een geldige PackageIdentifier- parameter opgeven. Als het Identifier veld NULLis, wordt de PackageIdentifier parameter genegeerd.
LimitAccess [invoer]
Deze parameter wordt genegeerd vanaf Windows 8.1 en Windows Server 2012 R2.
Windows 8 en Windows Server 2012:
Een Booleaanse waarde die aangeeft of Windows Update (WU) moet worden opgenomen als bronlocatie voor het downloaden van bestanden als er geen bestanden worden gevonden op andere opgegeven locaties. Voordat u WU controleert, controleert DISM op de bestanden in de opgegeven SourcePaths en op alle locaties die door groepsbeleid in het register zijn gespecificeerd. Als de bestanden die nodig zijn om de functie in te schakelen nog steeds aanwezig zijn op de computer, wordt deze vlag genegeerd.
| Waarde | Beschrijving |
|---|---|
| WAAR | Controleer WU niet op reparatiebestanden. |
| ONWAAR | Verstek. Controleer Windows Update op reparatiebestanden. |
SourcePaths [in, optioneel]
Deze parameter wordt genegeerd vanaf Windows 8.1 en Windows Server 2012 R2.
Windows 8 en Windows Server 2012:
Een lijst met bronlocaties om te controleren op bestanden die nodig zijn om de functie in te schakelen.
SourcePathCount [in, optioneel]
Deze parameter wordt genegeerd vanaf Windows 8.1 en Windows Server 2012 R2.
Windows 8 en Windows Server 2012:
Het aantal opgegeven bronlocaties.
EnableAll [in]
Schakel alle afhankelijkheden van de functie in. Als de opgegeven functie of een van de bijbehorende afhankelijkheden niet kan worden ingeschakeld, worden ze niet gewijzigd van hun bestaande status.
| Waarde | Beschrijving |
|---|---|
| WAAR | Schakel alle afhankelijkheden van de functie in. |
| ONWAAR | Schakel alleen de opgegeven functie in. |
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 |
|---|---|
|
Als de Sessie online is, moet de computer opnieuw worden opgestart. |
|
De -sessie moet opnieuw worden geladen. |
Als de functie mislukt, is de retourwaarde een HRESULT-foutwaarde.
Opmerkingen
Als de functie aanwezig is in het basispakket, hoeft u geen pakketgegevens op te geven. Als de functie zich in een optioneel pakket of onderdeelpakket bevindt dat al in de installatiekopieën is geïnstalleerd, geeft u een pakketnaam op in de parameter Id en geeft u DismPackageName- op als de PackageIdentifier-. Als de functie niet kan worden ingeschakeld omdat de bovenliggende functie niet is ingeschakeld, wordt er een speciale foutcode geretourneerd. U kunt EnableAll gebruiken om de bovenliggende functies in te schakelen wanneer u de opgegeven functies inschakelt, of u kunt de DismGetFeatureParent- gebruiken om de bovenliggende functies op te sommen en ze eerst in te schakelen.
Belangrijk
Als de functie die moet worden ingeschakeld geen onderdeel is van het basispakket, moet u het bovenliggende optionele pakket toevoegen met de DismAddPackage voordat u de functie inschakelt. Geef geen pad op naar een .cab bestand van een optioneel pakket dat niet is toegevoegd aan de afbeelding in de parameter Identifier. Als u een pakket opgeeft dat niet is toegevoegd en u DismPackagePath- opgeeft als de PackageIdentifier-, wordt de functie voltooid, maar wordt de functie niet ingeschakeld.
Notitie
LimitAccess, SourcePaths, SourcePathCounten EnableAll worden alleen ondersteund in Windows 8 en Windows Server 2012.
Voorbeeld
HRESULT hr = S_OK;
hr = DismEnableFeature(Session, “WindowsMediaPlayer”, NULL, PackageNone, TRUE, NULL, 0, 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 |