Aracılığıyla paylaş

IMetaDataInfo::GetFileMapping Method

Eşlenen dosyanın bellek bölgesini ve eşleme türünü alır.

Syntax

HRESULT GetFileMapping (
    [out] const void           **ppvData,
    [out] ULONGLONG            *pcbData,
    [out] DWORD                *pdwMappingType
);

Parameters

ppvData [out] Eşlenen dosyanın başlangıcına ilişkin bir işaretçi.

pcbData [out] Eşlenen bölgenin boyutu. ise pdwMappingTypefmFlat, bu dosyanın boyutudur.

pdwMappingType [out] Eşleme türünü gösteren bir CorFileMapping değeri. Ortak dil çalışma zamanının (CLR) geçerli uygulaması her zaman döndürür fmFlat. Diğer değerler gelecekte kullanılmak üzere ayrılmıştır. Ancak, diğer değerler gelecekteki sürümlerde veya hizmet sürümlerinde etkinleştirilebileceği için döndürülen değeri her zaman doğrulamanız gerekir.

Return Value

HRESULT Description
S_OK Tüm çıkışlar doldurulur.
E_INVALIDARG NULL bağımsız değişken değeri olarak geçirildi.
COR_E_NOTSUPPORTED CLR uygulaması bellek bölgesi hakkında bilgi sağlayamıyor. Bu durum aşağıdaki nedenlerle oluşabilir:

- Meta veri kapsamı veya ofCopyMemory bayrağıyla ofWrite açıldı.
- Meta veri kapsamı bayrağı olmadan ofReadOnly açıldı.
- Dosyanın yalnızca meta veri bölümünü açmak için IMetaDataDispenser::OpenScopeOnMemory yöntemi kullanıldı.
- Dosya taşınabilir bir yürütülebilir dosya (PE) dosyası değil. Not: Bu koşullar CLR uygulamasına bağlıdır ve CLR'nin gelecek sürümlerinde zayıflama olasılığı yüksektir.

Remarks

İşaret eden ppvData bellek yalnızca temel meta veri kapsamı açık olduğu sürece geçerlidir.

Bu yöntemin çalışması için, IMetaDataDispenser::OpenScope yöntemini çağırarak disk üzerindeki bir dosyanın meta verilerini belleğe eşlerken, bayrağını belirtmeniz ofReadOnly ve veya ofCopyMemory bayrağını ofWrite belirtmemelisiniz.

Her kapsam için dosya eşleme türü seçimi, CLR'nin belirli bir uygulamasına özgüdür. Kullanıcı tarafından ayarlanamaz. CLR'nin geçerli uygulaması her zaman içinde pdwMappingTypedöndürürfmFlat, ancak bu durum CLR'nin gelecek sürümlerinde veya belirli bir sürümün gelecekteki hizmet sürümlerinde değişebilir. farklı türlerin farklı düzenleri ve uzaklıkları olacağı için, içinde pdwMappingTypedöndürülen değeri her zaman denetlemeniz gerekir.

Üç parametreden herhangi biri için NULL geçişi desteklenmez. yöntemi döndürür E_INVALIDARGve çıkışların hiçbiri doldurulmaz. Eşleme türünün veya bölgenin boyutunun yoksayılması anormal program sonlandırması ile sonuçlanabilir.

Requirements

Platform: Bkz. .NET tarafından desteklenen işletim sistemleri.

Header: Cor.h

Library: CorGuids.lib

.NET sürümleri: .NET Framework 4.0'dan itibaren kullanılabilir

See also

  • Last updated on