HcsCreateComputeSystem

Açıklama

Yeni bir işlem sistemi oluşturur, basit örnek için bkz. örnek kod.

Sözdizimi

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

Parametreler

id

İşlem sistemini tanımlayan benzersiz kimlik.

configuration

işlem sisteminin ayarlarını belirten JSON belgesi. İşlem sistemi belgesinde birbirini dışlayan bir Container, VirtualMachine veya HostedSystem özelliği ayarlanmış olması beklenir.

operation

Oluşturma işlemini izleyen işlemin tanıtıcısı.

securityDescriptor

Gelecekte kullanmak üzere ayrılmış olmalıdır, NULLolmalıdır.

computeSystem

Yeni oluşturulan işlem sistemine bir tanıtıcı alır. Artık kullanımda olmadığında HcsCloseComputeSystem kullanarak tanıtıcıyı serbest bırakmak çağıranın sorumluluğundadır.

Dönüş Değerleri

işlevi HRESULT döndürür.

Dönüş değeri S_OKise, işlemin başarıyla başlatılıp başlatılmayeceği anlamına gelir. Çağıranların HcsWaitForOperationResult veya HcsGetOperationResultkullanarak işlemin sonucunu alması beklenir.

İşlem Sonuçları

Aşağıda listelenen geçerli işleme göre HcsWaitForOperationResult veya HcsGetOperationResult dönüş değeri.

İşlem Sonucu Değeri	Açıklama
S_OK	İşlem sistemi başarıyla oluşturuldu
HCS_E_OPERATION_PENDING	İşlem sistemi henüz tam olarak oluşturulmadı
Diğer Windows HRESULT değeri	İşlem sistemini oluştururken bir sorun oluştuysa, buradaki dönüş değeri neyin yanlış gitmiş olabileceğine ilişkin ipuçları verir

İşlemin sonucu S_OKdeğilse, sonuç belgesinde hata iletisi olabilir.

Gereksinimler

Parametre	Açıklama
desteklenen en düşük istemci	Windows 10, sürüm 1809
Desteklenen en düşük sunucu	Windows Server 2019
hedef platform	Windows
Başlık	ComputeCore.h
Kütüphane	ComputeCore.lib
Dll	ComputeCore.dll