HcsCreateComputeSystem

Deskripsi

Membuat sistem komputasi baru, lihat kode sampel untuk contoh sederhana.

Sintaksis

HRESULT WINAPI
HcsCreateComputeSystem(
    _In_ PCWSTR id,
    _In_ PCWSTR configuration,
    _In_ HCS_OPERATION operation,
    _In_opt_ const SECURITY_DESCRIPTOR* securityDescriptor,
    _Out_ HCS_SYSTEM* computeSystem
    );

Parameter-parameternya

id

Id unik yang mengidentifikasi sistem komputasi.

configuration

Dokumen JSON yang menentukan pengaturan sistem komputasi . Dokumen sistem komputasi diharapkan memiliki properti Container, VirtualMachine atau HostedSystem yang ditetapkan karena saling eksklusif.

operation

Handel ke operasi yang melacak operasi buat.

securityDescriptor

Dicadangkan untuk digunakan di masa mendatang, harus NULL.

computeSystem

Menerima handel ke sistem komputasi yang baru dibuat. Pemanggil bertanggung jawab untuk melepaskan handel menggunakan HcsCloseComputeSystem setelah tidak lagi digunakan.

Mengembalikan Nilai

Fungsi mengembalikan HRESULT.

Jika nilai yang dikembalikan S_OK, itu berarti operasi berhasil dimulai. Penelepon diharapkan mendapatkan hasil operasi menggunakan HcsWaitForOperationResult atau HcsGetOperationResult.

Hasil Operasi

Nilai pengembalian HcsWaitForOperationResult atau HcsGetOperationResult berdasarkan operasi saat ini yang tercantum seperti di bawah ini.

Nilai Hasil Operasi	Deskripsi
S_OK	Sistem komputasi berhasil dibuat
HCS_E_OPERATION_PENDING	Sistem komputasi belum sepenuhnya dibuat
Nilai windows HRESULT lainnya	Jika terjadi kesalahan saat membuat sistem komputasi, nilai pengembalian di sini akan memberikan petunjuk tentang apa yang mungkin salah

Jika hasil operasi tidak S_OK, kemungkinan dokumen hasil mungkin berisi pesan kesalahan.

Persyaratan

Pengaturan	Deskripsi
klien minimum yang didukung	Windows 10, versi 1809
server minimum yang didukung	Windows Server 2019
Platform Target	Windows
Tajuk	ComputeCore.h
Perpustakaan	ComputeCore.lib
Dll	ComputeCore.dll