Funzione DismRemoveCapability
Aggiunge una funzionalità a un'immagine.
Sintassi
HRESULT WINAPI DismRemoveCapability(
_In_ DismSession Session,
_In_ PCWSTR Name,
_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 rimuovere
CancelEvent [in, facoltativo]
Si tratta di un handle per un evento per l'annullamento.
Avanzamento [opzionale, in]
Puntatore a una funzione di callback definita dal client per segnalare il progresso.
UserData [in, facoltativo]
Dati personalizzati definiti dall'utente. Verrà passato 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. |
|
La sessione di deve essere ricaricata. |
Se la funzione ha esito negativo, il valore restituito è un valore di errore HRESULT.
Osservazioni
Usare questa funzione per rimuovere una funzionalità.
Esempio
HRESULT hr = S_OK;
hr = DismRemoveCapability(Session, L“Language.Basic~~~en-US~0.0.1.0”, NULL, NULL, NULL);
Requisiti
| Requisito | Descrizione |
|---|---|
| Piattaforme host supportate | 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 le app desktop] |
| Server minimo supportato | Windows Server 2016 [solo app di desktop] |
| Intestazione | DismAPI.h |
| Biblioteca | DismAPI.lib |
| DLL | DismAPI.dll |