CreateVersionStringFromModule, funkcja dla programu Silverlight

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 Wymagania systemowe.

Nagłówek: dbgshim.h

Biblioteka: dbgshim.dll

Wersje programu .NET Framework: 3.5 z dodatkiem SP1