PEReader Konstruktory

Definice

Obor názvů:

System.Reflection.PortableExecutable

Sestavení:

System.Reflection.Metadata.dll

Přetížení

PEReader(ImmutableArray<Byte>)	Vytvoří čtečku přenosného spustitelného souboru přes bitovou kopii pe uloženou v bajtovém poli.
PEReader(Stream)	Vytvoří čtečku přenosného spustitelného souboru přes bitovou kopii pe uloženou ve streamu.
PEReader(Byte*, Int32)	Vytvoří čtečku přenosného spustitelného souboru přes bitovou kopii pe uloženou v paměti.
PEReader(Stream, PEStreamOptions)	Vytvoří čtečku přenosného spustitelného souboru přes obrázek PE uložený ve streamu, který začíná na aktuální pozici a končí na konci streamu.
PEReader(Byte*, Int32, Boolean)	Vytvoří čtečku přenosného spustitelného souboru přes bitovou kopii pe uloženou v paměti. Příznak označuje, jestli už image byla načtena do paměti.
PEReader(Stream, PEStreamOptions, Int32)	Vytvoří čtečku přenosného spustitelného souboru na obrázku PE o dané velikosti počínaje aktuální pozicí streamu.

PEReader(ImmutableArray<Byte>)

Zdroj:

PEReader.cs

Vytvoří čtečku přenosného spustitelného souboru přes bitovou kopii pe uloženou v bajtovém poli.

public:
 PEReader(System::Collections::Immutable::ImmutableArray<System::Byte> peImage);

public PEReader (System.Collections.Immutable.ImmutableArray<byte> peImage);

new System.Reflection.PortableExecutable.PEReader : System.Collections.Immutable.ImmutableArray<byte> -> System.Reflection.PortableExecutable.PEReader

Public Sub New (peImage As ImmutableArray(Of Byte))

Parametry

peImage

ImmutableArray<Byte>

Neměnné pole bajtů představující obrázek pe.

Výjimky

ArgumentNullException

peImage je null.

Poznámky

Obsah obrázku se při vytváření PEReader

PEReader(Stream)

Zdroj:

PEReader.cs

Vytvoří čtečku přenosného spustitelného souboru přes bitovou kopii pe uloženou ve streamu.

public:
 PEReader(System::IO::Stream ^ peStream);

public PEReader (System.IO.Stream peStream);

new System.Reflection.PortableExecutable.PEReader : System.IO.Stream -> System.Reflection.PortableExecutable.PEReader

Public Sub New (peStream As Stream)

Parametry

peStream

Stream

Datový proud obrázků PE.

Výjimky

ArgumentNullException

peStream je null.

Poznámky

Vlastnictví datového proudu se po úspěšném ověření argumentů konstruktoru přenese do objektu PEReader . Bude odstraněna a PEReader volající s ním nesmí manipulovat.

PEReader(Byte*, Int32)

Zdroj:

PEReader.cs

Vytvoří čtečku přenosného spustitelného souboru přes bitovou kopii pe uloženou v paměti.

public:
 PEReader(System::Byte* peImage, int size);

public PEReader (byte* peImage, int size);

new System.Reflection.PortableExecutable.PEReader : nativeptr<byte> * int -> System.Reflection.PortableExecutable.PEReader

Parametry

peImage

Byte*

Ukazatel na začátek bitové kopie pe.

size

Int32

Velikost bitové kopie pe.

Výjimky

ArgumentNullException

peImage je Zero.

ArgumentOutOfRangeException

size je negativní.

Poznámky

Paměť je vlastněna volajícím a není uvolněna při likvidaci PEReader. Volající zodpovídá za udržování paměti naživu a beze změny po celou dobu životnosti objektu PEReader.

Obsah obrázku se při vytváření PEReader

PEReader(Stream, PEStreamOptions)

Zdroj:

PEReader.cs

Vytvoří čtečku přenosného spustitelného souboru přes obrázek PE uložený ve streamu, který začíná na aktuální pozici a končí na konci streamu.

public:
 PEReader(System::IO::Stream ^ peStream, System::Reflection::PortableExecutable::PEStreamOptions options);

public PEReader (System.IO.Stream peStream, System.Reflection.PortableExecutable.PEStreamOptions options);

new System.Reflection.PortableExecutable.PEReader : System.IO.Stream * System.Reflection.PortableExecutable.PEStreamOptions -> System.Reflection.PortableExecutable.PEReader

Public Sub New (peStream As Stream, options As PEStreamOptions)

Parametry

peStream

Stream

Datový proud image PE.

options

PEStreamOptions

Možnosti určující, jak se části image PE čtou ze streamu.

Výjimky

ArgumentNullException

peStream je null.

ArgumentOutOfRangeException

options má neplatnou hodnotu.

IOException

Při čtení ze streamu došlo k chybě (pouze při předběžném načtení dat).

BadImageFormatException

PrefetchMetadata je zadán a hlavičky PE obrázku jsou neplatné.

Poznámky

Pokud není PEStreamOptions.LeaveOpen zadáno, vlastnictví datového proudu se při úspěšném ověření argumentu přenese do datového PEReader proudu. Bude odstraněna a PEReader volající s ním nesmí manipulovat.

Pokud není PEStreamOptions.PrefetchMetadata zadáno nebo PEStreamOptions.PrefetchEntireImage není zadáno, nečtou se během vytváření datového PEReaderproudu žádná data. Kromě toho nesmí být s datovým proudem manipulován volajícím, pokud PEReader je aktivní a nedisponovaný.

Pokud options obsahuje PEStreamOptions.PrefetchMetadata nebo PEStreamOptions.PrefetchEntireImage, PEReader přečte všechna data požadovaná během výstavby. Jako takový, pokud PEStreamOptions.LeaveOpen je také zadán, volající si ponechá úplné vlastnictví streamu a je ujištěn, že s ním nebude manipulován PEReader po konstrukci.

PEReader(Byte*, Int32, Boolean)

Zdroj:

PEReader.cs

Vytvoří čtečku přenosného spustitelného souboru přes bitovou kopii pe uloženou v paměti. Příznak označuje, jestli už image byla načtena do paměti.

public:
 PEReader(System::Byte* peImage, int size, bool isLoadedImage);

public PEReader (byte* peImage, int size, bool isLoadedImage);

new System.Reflection.PortableExecutable.PEReader : nativeptr<byte> * int * bool -> System.Reflection.PortableExecutable.PEReader

Parametry

peImage

Byte*

Ukazatel na začátek bitové kopie pe.

size

Int32

Velikost bitové kopie pe.

isLoadedImage

Boolean

truepokud byla bitová kopie PE načtena do paměti zavaděčem operačního systému; v opačném případě . false

Výjimky

ArgumentNullException

peImage je Zero.

ArgumentOutOfRangeException

size je negativní.

Poznámky

Paměť je vlastněna volajícím a není uvolněna, když PEReader je odstraněna. Volající zodpovídá za udržování paměti naživu a beze změny po celou dobu životnosti objektu PEReader.

Obsah obrázku se při vytváření PEReader

PEReader(Stream, PEStreamOptions, Int32)

Zdroj:

PEReader.cs

Vytvoří čtečku přenosného spustitelného souboru na obrázku PE o dané velikosti počínaje aktuální pozicí streamu.

public:
 PEReader(System::IO::Stream ^ peStream, System::Reflection::PortableExecutable::PEStreamOptions options, int size);

public PEReader (System.IO.Stream peStream, System.Reflection.PortableExecutable.PEStreamOptions options, int size);

new System.Reflection.PortableExecutable.PEReader : System.IO.Stream * System.Reflection.PortableExecutable.PEStreamOptions * int -> System.Reflection.PortableExecutable.PEReader

Public Sub New (peStream As Stream, options As PEStreamOptions, size As Integer)

Parametry

peStream

Stream

Datový proud image PE.

options

PEStreamOptions

Možnosti určující, jak se části image PE čtou ze streamu.

size

Int32

Velikost obrázku PE.

Výjimky

ArgumentOutOfRangeException

size je záporná nebo přesahuje konec datového proudu.

IOException

Při čtení ze streamu došlo k chybě (pouze při předběžném načtení dat).

BadImageFormatException

PrefetchMetadata je zadán a hlavičky PE obrázku jsou neplatné.

Poznámky

Pokud není PEStreamOptions.LeaveOpen zadáno, vlastnictví datového proudu se při úspěšném ověření argumentu přenese do datového PEReader proudu. Vyhodí ho PEReadera volající s ním nesmí manipulovat.

Pokud není PEStreamOptions.PrefetchMetadata zadáno nebo PEStreamOptions.PrefetchEntireImage není zadáno, nečtou se během vytváření datového PEReaderproudu žádná data. Kromě toho nesmí být datový proud manipulován volajícím, pokud PEReader je aktivní a nedisponovaný.

Pokud options obsahuje PEStreamOptions.PrefetchMetadata hodnoty nebo PEStreamOptions.PrefetchEntireImage , PEReader nástroj přečte všechna data požadovaná během výstavby. Jako takový, pokud PEStreamOptions.LeaveOpen je také zadán, volající si ponechá úplné vlastnictví streamu a je ujištěn, že s ním nebude manipulován PEReader po konstrukci.