ICLRDebuggingLibraryProvider3::P rovideUnixLibrary yöntemi

Hata ayıklayıcının macOS ve Linux üzerinde sürüme özgü ortak dil çalışma zamanı (CLR) hata ayıklama kitaplığının yolunu sağlamasına olanak tanır.

Sözdizimi

HRESULT ProvideUnixLibrary (
     [in] const WCHAR* pwszFileName,
     [in] const WCHAR* pwszRuntimeModule,
     [in] LIBRARY_PROVIDER_INDEX_TYPE indexType,
     [in] BYTE* pbBuildId,
     [in] int iBuildIdSize,
     [out] LPWSTR* ppResolvedModulePath);

Parametreler

pwszFilename
[in] İstenen modülün adı.

pwszRuntimeModule
[in] Çalışma zamanı veya tek dosyalı modül yolu.

indexType
[in] Sağlanan dizin bilgilerinin (pBuildId) türü. Bkz. LIBRARY_PROVIDER_INDEX_TYPE sabit listesi.

pbBuildId
[in] Linux veya macOS modülü derleme kimliği. Derleme kimliği alınırken bir sorun oluştuysa null olabilir.

iBuildIdSize
[in] pbBuildId dizisindeki bayt sayısı. Derleme kimliği alınırken bir sorun oluştuysa 0 olabilir.

ppResolvedModulePath
[out] Bu, modül dll'sinin null sonlandırılan yoludur. Unix'te CoTaskMemAlloc ile ayrılmalıdır. Unix'te malloc ile ayrılmalıdır. Başarısızlık onu dokunulmadan bırakır. Aşağıdaki güvenlik notunu inceleyin!

Dönüş değeri

Bu yöntem, aşağıdaki belirli HRESULT ve yöntem hatasını gösteren HRESULT hatalarını döndürür.

HRESULT	Açıklama
S_OK	Yöntem başarıyla tamamlandı.

Açıklamalar

ProvideUnixLibrary hata ayıklayıcının mscordbi.dll ve mscordacwks.dllgibi belirli CLR dosyalarında hata ayıklamak için gereken modülleri sağlamasına olanak tanır.

Hata ayıklayıcı, hata ayıklama modülünü bulmak veya temin etmek için kullanılabilir herhangi bir aracı kullanabilir.

Önemli

Bu özellik, API çağıranın yürütülebilir ve büyük olasılıkla kötü amaçlı kod içeren modüller sağlamasına olanak tanır. Bir güvenlik önlemi olarak, çağıranın kendisini yürütmeye istekli olmadığı herhangi bir kodu dağıtmak için kullanmaması ProvideUnixLibrary gerekir.

mscordbi.dll veya mscordacwks.dllgibi zaten yayımlanmış bir kitaplıkta ciddi bir güvenlik sorunu bulunursa dolguya dosyaların kötü sürümlerini tanımak için düzeltme eki uygulanabilir. Dolgu daha sonra dosyaların düzeltme eki eklenmiş sürümleri için istek gönderebilir ve herhangi bir isteğe yanıt olarak sağlanırsa hatalı sürümleri reddedebilir. Bu durum yalnızca kullanıcı dolgunun yeni bir sürümüne yama yapmışsa oluşabilir. Eşleşmeyen sürümler savunmasız kalır.

Gereksinimler

Platform: Bkz. .NET tarafından desteklenen işletim sistemleri.

Üst bilgi: dbgshim.h

Kitaplık: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

.NET Sürümleri: .NET Core 2.1'den itibaren kullanılabilir