ICLRDebuggingLibraryProvider3::P rovideWindowsLibrary, metoda

Pobiera interfejs wywołania zwrotnego dostawcy biblioteki, który umożliwia zlokalizowanie i załadowanie bibliotek debugowania specyficznych dla środowiska uruchomieniowego języka wspólnego (CLR) na żądanie.

Składnia

HRESULT ProvideWindowsLibrary (
     [in] const WCHAR* pwszFileName,
     [in] const WCHAR* pwszRuntimeModule,
     [in] LIBRARY_PROVIDER_INDEX_TYPE indexType,
     [in] DWORD dwTimestamp,
     [in] DWORD dwSizeOfImage,
     [out] LPWSTR* ppResolvedModulePath);

Parametry

pwszFilename
[in] Nazwa żądanego modułu.

pwszRuntimeModule
[in] Ścieżka modułu środowiska uruchomieniowego lub pojedynczego pliku.

indexType
[in] Podany typ informacji o indeksie (dwTimestamp/dwSizeOfImage). Zobacz LIBRARY_PROVIDER_INDEX_TYPE wyliczenie .

dwTimestamp
[in] Sygnatura czasowa daty przechowywana w nagłówku pliku COFF plików PE.

dwSizeOfImage
[in] Pole SizeOfImage przechowywane w opcjonalnym nagłówku pliku COFF plików PE.

ppResolvedModulePath
[out] Jest to ścieżka zakończona o wartości null do biblioteki dll modułu. W systemie Windows należy go przydzielić za pomocą polecenia CoTaskMemAlloc. W systemie Unix należy go przydzielić malloc. Niepowodzenie pozostawia go nietknięte. Zobacz poniższą notatkę zabezpieczeń!

Wartość zwracana

Ta metoda zwraca następujące konkretne błędy HRESULT, a także HRESULT, które wskazują błąd metody.

HRESULT	Opis
S_OK	Metoda została ukończona pomyślnie.

Uwagi

ProvideWindowsLibrary umożliwia debugerowi udostępnianie modułów potrzebnych do debugowania określonych plików CLR, takich jak mscordbi.dll i mscordacwks.dll.

Debuger może użyć dowolnych dostępnych środków do zlokalizowania lub pozyskania modułu debugowania.

Ważne

Ta funkcja umożliwia wywołującym interfejs API udostępnianie modułów zawierających pliki wykonywalne i potencjalnie złośliwe kod. Jako środek ostrożności, obiekt wywołujący nie ProvideWindowsLibrary powinien używać do rozpowszechniania żadnego kodu, którego nie chce wykonać.

Jeśli wykryto poważny problem z zabezpieczeniami w już wydanej bibliotece, takiej jak mscordbi.dll lub mscordacwks.dll, podkładka może zostać poprawiona w celu rozpoznania nieprawidłowych wersji plików. Podkładka może następnie wysyłać żądania dotyczące poprawek wersji plików i odrzucać nieprawidłowe wersje, jeśli są one podane w odpowiedzi na każde żądanie. Taka sytuacja może wystąpić tylko wtedy, gdy użytkownik wprowadził poprawkę do nowej wersji podkładki. Wersje bez poprawek pozostaną podatne na zagrożenia.

Wymagania

Platformy: Zobacz Obsługiwane systemy operacyjne platformy .NET.

Nagłówek: dbgshim.h

Biblioteka: dbgshim.dll, libdbgshim.so, libdbgshim.dylib

Wersje platformy .NET: Dostępne od wersji .NET Core 2.1