CreateVersionStringFromModule, funkcja

Tworzy ciąg wersji ze ścieżki środowiska uruchomieniowego języka wspólnego (CLR) w procesie docelowym.

Składnia

HRESULT CreateVersionStringFromModule (
    [in]  DWORD      pidDebuggee,
    [in]  LPCWSTR    szModuleName,
    [out, size_is(cchBuffer),
    length_is(*pdwLength)] LPWSTR Buffer,
    [in]  DWORD      cchBuffer,
    [out] DWORD*     pdwLength
);

Parametry

pidDebuggee
[in] Identyfikator procesu, w którym jest ładowana docelowa clR.

szModuleName
[in] Pełna lub względna ścieżka do docelowego środowiska CLR załadowanego w procesie.

pBuffer
[out] Bufor zwracany do przechowywania ciągu wersji dla docelowego środowiska CLR.

cchBuffer
[in] pBufferRozmiar .

pdwLength
[out] Długość ciągu wersji zwróconego przez pBufferelement .

Wartość zwracana

S_OK
Ciąg wersji docelowego środowiska CLR został pomyślnie zwrócony w pliku pBuffer.

E_INVALIDARG
szModuleName ma wartość null lub pBuffercchBuffer ma wartość null. pBuffer i cchBuffer musi mieć wartość null lub wartość inną niż null.

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
pdwLength wartość jest większa niż cchBuffer. Może to być oczekiwany wynik, jeśli przekazano wartość null dla parametrów pBuffer i cchBuffer, i wykonano zapytanie dotyczące niezbędnego rozmiaru buforu przy użyciu polecenia pdwLength.

HRESULT_FROM_WIN32(ERROR_MOD_NOT_FOUND)
szModuleName nie zawiera ścieżki do prawidłowego środowiska CLR w procesie docelowym.

E_FAIL (lub inne E_ kody powrotne)
pidDebuggee nie odnosi się do prawidłowego procesu lub innego błędu.

Uwagi

Ta funkcja akceptuje proces CLR, który jest identyfikowany przez pidDebuggee i ścieżkę ciągu, która jest określona przez szModuleName. Ciąg wersji jest zwracany w buforze wskazującym pBuffer . Ten ciąg jest nieprzezroczystym dla użytkownika funkcji; oznacza to, że w samym ciągu wersji nie ma znaczenia wewnętrznego. Jest ona używana wyłącznie w kontekście tej funkcji i funkcji CreateDebuggingInterfaceFromVersion.

Ta funkcja powinna być wywoływana dwukrotnie. Po wywołaniu go po raz pierwszy przekaż wartość null dla parametrów i pBuffercchBuffer. W takim przypadku rozmiar buforu niezbędnego do pBuffer użycia zostanie zwrócony w pliku pdwLength. Następnie można wywołać funkcję po raz drugi i przekazać bufor w pBuffer pliku i jego rozmiar w pliku cchBuffer.

Wymagania

Platformy: zobacz Obsługiwane systemy operacyjne .NET.

Nagłówek: dbgshim.h

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

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