Fungsi DismAddCapability

2023-05-30

Menambahkan kemampuan ke gambar.

Sintaks

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
);

Parameter

Sesi [in]
DismSession yang valid. DismSession harus dikaitkan dengan gambar. Anda dapat mengaitkan sesi dengan gambar dengan menggunakan DismOpenSession.

Nama [in]
Nama kemampuan yang sedang ditambahkan.

LimitAccess [in]
Bendera menunjukkan apakah WU/WSUS harus dihubungi sebagai lokasi sumber untuk mengunduh payload kemampuan. Jika payload kemampuan yang akan ditambahkan ada, bendera diabaikan.

SourcePaths [in]
Daftar lokasi sumber. Fungsi ini akan mencari file payload yang dihapus dari lokasi yang ditentukan dalam SourcePaths, dan jika tidak ditemukan, lanjutkan pencarian dengan menghubungi WU/WSUS tergantung pada parameter LimitAccess.

SourcePathCount [in, opsional]
Jumlah entri dalam SourcePaths.

CancelEvent [in, opsional]
Ini adalah penanganan ke acara untuk pembatalan.

Kemajuan [dalam, opsional]
Arahkan ke fungsi panggilan balik yang ditentukan klien untuk melaporkan kemajuan.

UserData [in, opsional]
Data kustom yang ditentukan pengguna. Ini akan diteruskan kembali kepada pengguna melalui panggilan balik.

Mengembalikan nilai

Mengembalikan S_OK keberhasilan.

Keterangan

Gunakan fungsi ini untuk menambahkan kemampuan.

Contoh

HRESULT hr = S_OK;
hr = DismAddCapability(Session, L“Language.Basic~~~en-US~0.0.1.0”, TRUE, NULL, 0, NULL, NULL, NULL);

Persyaratan

Persyaratan	Deskripsi
Platform host yang didukung	DISM API dapat digunakan pada sistem operasi apa pun yang didukung oleh Windows Assessment and Deployment Kit (Windows ADK). Untuk informasi selengkapnya, lihat Referensi Teknis Windows ADK.
Platform gambar yang didukung	Windows 10, Windows Server 2016
Klien minimum yang didukung	Windows 10 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Header	DismAPI.h
Pustaka	DismAPI.lib
DLL	DismAPI.dll