Fungsi CreateVersionStringFromModule

Membuat string versi dari jalur runtime bahasa umum (CLR) dalam proses target.

Sintaksis

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

Parameter-parameternya

pidDebuggee
[di] Pengidentifikasi proses di mana CLR target dimuat.

szModuleName
[di] Jalur penuh atau relatif ke CLR target yang dimuat dalam proses.

pBuffer
[out] Kembalikan buffer untuk menyimpan string versi untuk CLR target.

cchBuffer
[di] pBufferUkuran .

pdwLength
[out] Panjang string versi yang dikembalikan oleh pBuffer.

Mengembalikan nilai

S_OK
String versi untuk CLR target berhasil dikembalikan di pBuffer.

E_INVALIDARG
szModuleName null, atau pBuffer atau cchBuffer null. pBuffer dan cchBuffer harus null atau non-null.

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
pdwLength lebih besar dari cchBuffer. Ini mungkin hasil yang diharapkan jika Anda telah melewati null untuk dan pBuffercchBuffer, dan mengkueri ukuran buffer yang diperlukan dengan menggunakan pdwLength.

HRESULT_FROM_WIN32(ERROR_MOD_NOT_FOUND)
szModuleName tidak berisi jalur ke CLR yang valid dalam proses target.

E_FAIL (atau kode pengembalian lainnya E_ )
pidDebuggee tidak mengacu pada proses yang valid, atau kegagalan lainnya.

Komentar

Fungsi ini menerima proses CLR yang diidentifikasi oleh pidDebuggee dan jalur string yang ditentukan oleh szModuleName. String versi dikembalikan dalam buffer yang pBuffer menunjuk ke. String ini buram untuk pengguna fungsi; artinya, tidak ada arti intrinsik dalam string versi itu sendiri. Ini hanya digunakan dalam konteks fungsi ini dan fungsi CreateDebuggingInterfaceFromVersion.

Fungsi ini harus dipanggil dua kali. Ketika Anda menyebutnya pertama kali, berikan null untuk dan pBuffercchBuffer. Ketika Anda melakukan ini, ukuran buffer yang diperlukan untuk pBuffer akan dikembalikan di pdwLength. Anda kemudian dapat memanggil fungsi untuk kedua kalinya, dan meneruskan buffer dan pBuffer ukurannya di cchBuffer.

Persyaratan

Platform: Lihat Sistem operasi yang didukung .NET.

Header: dbgshim.h

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

Versi .NET: Tersedia sejak .NET Core 2.1