Funzione DismAddPackage

Articolo
12/18/2024

Aggiunge un singolo file .cab o msu a un'immagine di Windows.

Sintassi

HRESULT WINAPI DismAddPackage(
  _In_     DismSession            Session,
  _In_     PCWSTR                 PackagePath,
  _In_     BOOL                   IgnoreCheck,
  _In_     BOOL                   PreventPending,
  _In_opt_ HANDLE                 CancelEvent,
  _In_opt_ DISM_PROGRESS_CALLBACK Progress,
  _In_opt_ PVOID                  UserData
);

Parametri

Sessione [in]
Un DismSession valido. La sessione Dism deve essere associata a un'immagine. È possibile associare una sessione a un'immagine usando la DismOpenSession.

PackagePath [in]
Percorso relativo o assoluto del file .cab o del file .msu da aggiungere, oppure una cartella contenente i file espansi di un singolo file .cab.

IgnoreCheck [in]
Valore booleano per specificare se ignorare i controlli di applicabilità interni eseguiti quando viene aggiunto un pacchetto.

Valore	Descrizione
VERO	Ignorare i controlli di applicabilità interni.
FALSO	Non ignorare i controlli di applicabilità interni.

Impedisci in sospeso [in]
Valore booleano per specificare se aggiungere un pacchetto se contiene azioni online in sospeso.

Valore	Descrizione
VERO	Impedire l'installazione di un pacchetto che ha azioni online in sospeso.
FALSO	Consentire l'installazione di un pacchetto che ha azioni online in sospeso.

CancelEvent [in, opzionale]
Opzionale. È possibile impostare un CancelEvent per questa funzione per annullare l'operazione in corso quando viene segnalata dal client. Se il CancelEvent viene ricevuto in una fase in cui l'operazione non può essere annullata, l'operazione continuerà e restituirà un codice di operazione riuscita. Se viene ricevuto il CancelEvent e l'operazione è annullata, lo stato dell'immagine è sconosciuto. È necessario verificare lo stato dell'immagine prima di continuare o rimuovere le modifiche e ricominciare.

avanzamento [opzionale]
Opzionale. Puntatore a un definito dal client DismProgressCallback.

DatiUtente [in, facoltativo]
Opzionale. Dati personalizzati definiti dall'utente.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è S_OK. La funzione può anche restituire uno dei valori seguenti quando ha esito positivo:

Codice restituito	Descrizione
(HRESULT)ERRORE_RIUSCITO_RIAVVIO_RICHIESTO	Se la sessione è online, occorre riavviare il computer.
DISMAPI_S_RELOAD_IMAGE_SESSION_REQUIRED	La sessione del deve essere ricaricata.

Se la funzione ha esito negativo, il valore restituito è un valore di errore HRESULT.

Osservazioni

Solo i file .cab possono essere aggiunti a un'immagine online. I file .cab o i file .msu possono essere aggiunti a un'immagine offline.

Questa funzione restituirà un codice di errore speciale se il pacchetto non è applicabile. È possibile usare il DismGetPackageInfo per determinare se un pacchetto è applicabile all'immagine di destinazione.

Esempio

HRESULT hr = S_OK;
hr = DismAddPackage(Session, "C:\\packages\\calc.cab", FALSE, FALSE, NULL, NULL, NULL);

Requisiti

Requisito	Descrizione
Piattaforme ospitanti supportate	L'API DISM può essere usata in qualsiasi sistema operativo supportato da Windows Assessment and Deployment Kit (Windows ADK). Per ulteriori informazioni, consultare la Guida di riferimento tecnico di Windows ADK.
Piattaforme di immagini supportate	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
Client minimo supportato	Windows 7 [solo applicazioni desktop]
Server minimo supportato	Windows Server 2008 R2 [solo applicazioni desktop]
Intestazione	DismAPI.h
Biblioteca	DismAPI.lib
DLL	DismAPI.dll