Funkcja DismDisableFeature
Wyłącza funkcję na bieżącym obrazie.
Składnia
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
Sesja [in]
Prawidłowa DismSession. DismSession musi być skojarzony z obrazem. Sesję można skojarzyć z obrazem przy użyciu DismOpenSession.
FeatureName [in]
Nazwa funkcji, którą chcesz wyłączyć. Aby wyłączyć więcej niż jedną funkcję, należy oddzielić każdą nazwę funkcji średnikiem.
PackageName [in, opcjonalnie]
Fakultatywny. Nazwa pakietu nadrzędnego, którego częścią jest funkcja. Jeśli nie określono żadnego pakietu, zostanie użyty domyślny pakiet programu Windows Foundation.
RemovePayload [in]
Ten parametr nie jest obsługiwany, począwszy od systemu Windows Windows 8.1 i Windows Server 2012 R2.
Windows 8 i Windows Server 2012:
Wartość logiczna określająca, czy usunąć pliki wymagane do włączenia funkcji.
| Wartość | Opis |
|---|---|
| PRAWDZIWY | Pliki są usuwane. |
| FAŁSZYWY | Pliki nie są usuwane. |
CancelEvent [in, opcjonalny]
Fakultatywny. Dla tej funkcji można ustawić CancelEvent, aby anulować operację w toku, gdy zostanie to zasygnalizowane przez klienta. Jeśli CancelEvent zostanie odebrana na etapie, gdy nie można anulować operacji, operacja będzie kontynuowana i zwraca kod powodzenia. Jeśli CancelEvent zostanie odebrany i operacja zostanie anulowana, status obrazu jest nieznany. Przed kontynuowaniem lub odrzuceniem zmian należy zweryfikować stan obrazu i rozpocząć ponownie.
postęp [in, opcjonalnie]
Fakultatywny. Wskaźnik na zdefiniowaną przez klienta DismProgressCallback.
UserData [in, opcjonalny]
Fakultatywny. Dane niestandardowe zdefiniowane przez użytkownika.
Wartość zwracana
Jeśli funkcja powiedzie się, zwracana wartość jest S_OK. Funkcja może również zwrócić jedną z następujących wartości po pomyślnym wykonaniu następujących czynności:
| Kod powrotny | Opis |
|---|---|
|
Jeśli sesja jest online, należy ponownie uruchomić komputer. |
|
Trzeba ponownie załadować sesję . |
Jeśli funkcja zakończy się niepowodzeniem, zwracana wartość jest wartością błędu HRESULT.
Przykład
HRESULT hr = S_OK;
hr = DismDisableFeature(Session, "WindowsMediaPlayer", NULL, FALSE, NULL, NULL, NULL);
Wymagania
| Wymaganie | Opis |
|---|---|
| Obsługiwane platformy hostów | Interfejs API DISM może być używany w dowolnym systemie operacyjnym obsługiwanym przez zestaw Windows Assessment and Deployment Kit (Windows ADK). Aby uzyskać więcej informacji, zobacz Windows ADK Technical Reference. |
| Obsługiwane platformy plików graficznych | 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 |
| Minimalny obsługiwany klient | Windows 7 [tylko aplikacje klasyczne] |
| Minimalny obsługiwany serwer | Windows Server 2008 R2 [tylko aplikacje desktopowe] |
| Nagłówek | DismAPI.h |
| Biblioteka | DismAPI.lib |
| DLL | DismAPI.dll |