Funkcja DismRemovePackage
Usuwa pakiet z obrazu.
Składnia
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
sesji [in]
Prawidłowa DismSession. DismSession musi być skojarzony z obrazem. Sesję można skojarzyć z obrazem przy użyciu DismOpenSession.
identyfikator [in]
Ścieżka bezwzględna do pliku .cab lub nazwy pakietu w zależności od wartości parametru PackageIdentifier.
PackageIdentifier [in]
Fakultatywny. Prawidłowa wartość enumeracji DismPackageIdentifier.
| Wartość | Opis |
|---|---|
| PackageName | Użyj tej wartości, jeśli chcesz określić pakiet przy użyciu nazwy pakietu. |
| PackagePath | Użyj tej wartości, jeśli chcesz określić pakiet przy użyciu ścieżki bezwzględnej do pliku .cab. |
| PackageNone | Nieprawidłowa wartość dla tej funkcji. |
CancelEvent [in, opcjonalnie]
Fakultatywny. Można ustawić CancelEvent dla tej funkcji, aby anulować operację w toku, gdy zostanie to zgłoszone 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 zostanie odebrany CancelEvent i operacja zostanie anulowana, wówczas stan obrazu jest nieznany. Przed kontynuowaniem lub odrzuceniem zmian należy zweryfikować stan obrazu i rozpocząć ponownie.
postęp [w, opcjonalnie]
Fakultatywny. Wskaźnik do zdefiniowanej przez klienta DismProgressCallback.
UserData [in, opcjonalnie]
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 sesji jest w trybie online, należy ponownie uruchomić komputer. |
|
Należy ponownie załadować sesję . |
Jeśli funkcja zakończy się niepowodzeniem, zwracana wartość jest wartością błędu HRESULT.
Uwagi
Funkcja DismRemovePackage nie obsługuje plików .msu.
Przykład
HRESULT hr = S_OK;
hr = DismRemovePackage(Session, "C:\\packages\\test.CAB", PackagePath, 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 obrazów cyfrowych | 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 klasyczne] |
| Nagłówek | DismAPI.h |
| Biblioteka | DismAPI.lib |
| DLL | DismAPI.dll |