Bagikan melalui

Metode IHostAssemblyStore::ProvideModule

Menyelesaikan modul dalam perakitan atau file sumber daya yang ditautkan (tetapi bukan disematkan).

Sintaks

HRESULT ProvideModule (  
    [in]  ModuleBindInfo *pBindInfo,  
    [out] DWORD          *pdwModuleId,  
    [out] IStream        **ppStmModuleImage,  
    [out] IStream        **ppStmPDB  
);

Parameter

pBindInfo
[in] Penunjuk ke instans ModuleBindInfo yang menjelaskan AppDomain modul, rakitan, dan nama modul yang diminta.

pdwModuleId
[out] Penunjuk ke pengidentifikasi unik untuk IStream yang berisi modul yang dimuat.

ppStmModuleImage
[out] Penunjuk ke alamat objek IStream, yang berisi gambar portabel yang dapat dijalankan (PE) yang akan dimuat, atau null jika rakitan tidak dapat ditemukan.

ppStmPDB
[out] Penunjuk ke alamat objek IStream, yang berisi informasi debug program (PDB) untuk modul yang diminta, atau null jika file .pdb tidak dapat ditemukan.

Tampilkan Nilai

HRESULT Deskripsi
S_OK ProvideModule berhasil dikembalikan.
HOST_E_CLRNOTAVAILABLE Runtime bahasa umum (CLR) belum dimuat ke dalam proses, atau CLR berada dalam status yang tidak dapat menjalankan kode terkelola atau tidak berhasil memproses panggilan.
HOST_E_TIMEOUT Waktu panggilan habis.
HOST_E_NOT_OWNER Pemanggil tidak memiliki kunci.
HOST_E_ABANDONED Peristiwa dibatalkan saat rangkaian atau fiber yang diblokir sedang menunggunya.
E_FAIL Kegagalan katastrofe yang tidak diketahui terjadi. Saat metode menampilkan E_FAIL, CLR tidak lagi dapat digunakan dalam proses. Panggilan berikutnya ke metode hosting menampilkan HOST_E_CLRNOTAVAILABLE.
COR_E_FILENOTFOUND (0x80070002) Rakitan yang diminta atau sumber daya tertaut tidak dapat ditemukan.
E_NOT_SUFFICIENT_BUFFER pdwModuleId tidak cukup besar untuk berisi pengidentifikasi yang ingin ditampilkan oleh host.

Keterangan

Nilai identitas yang ditampilkan untuk pdwModuleId ditentukan oleh host. Pengidentifikasi harus unik dalam masa pakai suatu proses. Runtime bahasa umum menggunakan nilai ini sebagai pengenal unik untuk aliran terkait. Ini memeriksa setiap nilai terhadap nilai untuk pAssemblyId dikembalikan oleh panggilan ke ProvideAssembly dan terhadap nilai untuk pdwModuleId dikembalikan oleh panggilan lain ke ProvideModule. Jika host menampilkan nilai pengidentifikasi yang sama untuk IStream lainnya, runtime bahasa umum memeriksa apakah konten aliran tersebut telah dipetakan. Jika demikian, runtime bahasa umum memuat salinan gambar yang ada alih-alih memetakan yang baru. Oleh karena itu, pengidentifikasi juga tidak boleh tumpang tindih dengan pengidentifikasi rakitan yang dikembalikan dari ProvideAssembly.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.h

Pustaka: Disertakan sebagai sumber daya di MSCorEE.dll

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga

  • Last updated on