Aracılığıyla paylaş

ICLRDebugManager::BeginConnection Yöntemi

Görev listesini bir tanımlayıcı ve kolay bir adla ilişkilendirmek için konak ile hata ayıklayıcı arasında yeni bir bağlantı kurar.

Sözdizimi

HRESULT BeginConnection (  
    [in] CONNID dwConnectionId,  
    [in, string] wchar_t* szConnectionName  
);

Parametreler

dwConnectionId
[in] Ortak dil çalışma zamanı (CLR) görevleri listesiyle ilişkilendirilecek tanımlayıcı.

szConnectionName
[in] CLR görevleri listesiyle ilişkilendirilecek kolay ad.

Dönüş Değeri

HRESULT Description
S_OK BeginConnection başarıyla döndürüldü.
HOST_E_CLRNOTAVAILABLE CLR bir işleme yüklenmedi veya CLR yönetilen kodu çalıştıramadığı veya çağrıyı başarıyla işleyemediği bir durumda.
HOST_E_TIMEOUT Arama zaman aşımına uğradı.
HOST_E_NOT_OWNER Arayan, kilidin sahibi değil.
HOST_E_ABANDONED Engellenen bir iş parçacığı veya fiber beklerken bir olay iptal edildi.
E_FAIL Bilinmeyen bir yıkıcı hata oluştu. Bir yöntem E_FAIL döndürdüğünde CLR artık işlem içinde kullanılamaz. Barındırma yöntemlerine yapılan sonraki çağrılar HOST_E_CLRNOTAVAILABLE döndürür.
E_INVALIDARG dwConnectionId sıfırdı veya BeginConnection bu dwConnectionId değer kullanılarak zaten çağrıldı ya da szConnectionName null idi.
E_OUTOFMEMORY Bu bağlantıyla ilişkili görevlerin listesini tutmak için yeterli bellek ayrılamadı.

Açıklamalar

ICLRDebugManager , BeginConnectiongörev listelerini tanımlayıcılar ve kolay adlarla ilişkilendirmek için , SetConnectionTasks ve EndConnection adlı üç yöntem sağlar.

Önemli

Bu üç yöntem, her görev kümesi için belirli bir sırada çağrılmalıdır. BeginConnection yeni bir bağlantı kurmak için ilk olarak çağrılır. SetConnectionTasks , bu bağlantıyla ilişkilendirilecek görev kümesini sağlamak için yanında çağrılır. EndConnection görev listesi ile tanımlayıcı ve kolay ad arasındaki ilişkiyi kaldırmak için son olarak çağrılır. Ancak, farklı bağlantılar için çağrılar iç içe olabilir.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: MSCorEE.h

Kitaplığı: MSCorEE.dll'da kaynak olarak dahil edilen

.NET Framework Sürümleri: 2.0 sürümünden itibaren kullanılabilir

Ayrıca bkz.

  • Last updated on