Funzione DismAddCapability
Aggiunge una funzionalità a un'immagine.
Sintassi
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
);
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.
Nome [in]
Nome della funzionalità da aggiungere.
LimitAccess [in]
L'indicatore mostra se WU/WSUS deve essere contattato come fonte per scaricare il payload di una caratteristica. Se esiste il payload della funzionalità da aggiungere, il flag viene ignorato.
SourcePaths [in]
Elenco di postazioni di origine. La funzione cercherà i file di payload rimossi dai percorsi specificati in SourcePaths e, se non viene trovato, continuare la ricerca contattando WU/WSUS a seconda del parametro LimitAccess.
SourcePathCount [in, facoltativo]
Conteggio delle voci in SourcePaths.
CancelEvent [in, facoltativo]
Si tratta di un riferimento di un evento di annullamento.
Progresso [in, facoltativo]
Puntatore a una funzione di callback definita dal client per segnalare lo stato di avanzamento.
UserData [in, facoltativo]
Dati personalizzati definiti dall'utente. Il risultato verrà restituito all'utente tramite il callback.
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 |
|---|---|
|
Se la sessione è online, è necessario riavviare il computer. |
|
Il sessione di |
Se la funzione ha esito negativo, il valore restituito è un valore di errore HRESULT.
Osservazioni
Usare questa funzione per aggiungere una funzionalità.
Esempio
HRESULT hr = S_OK;
hr = DismAddCapability(Session, L“Language.Basic~~~en-US~0.0.1.0”, TRUE, NULL, 0, NULL, NULL, NULL);
Requisiti
| Requisito | Descrizione |
|---|---|
| Piattaforme supportate host | L'API DISM può essere usata in qualsiasi sistema operativo supportato da Windows Assessment and Deployment Kit (Windows ADK). Per altre informazioni, vedere la Guida di riferimento tecnico di Windows ADK. |
| Piattaforme di immagini supportate | Windows 10, Windows Server 2016 |
| Client minimo supportato | Windows 10 [solo applicazioni desktop] |
| Server minimo supportato | Windows Server 2016 [solo applicazioni desktop] |
| Intestazione | DismAPI.h |
| Biblioteca | DismAPI.lib |
| DLL | DismAPI.dll |