Microsoft.DiaSymReader.PortablePdb

Unique ID representing a document across all generations.

Info for each document, indexed by - 1.

Enumerates all documents that include at least one non-hidden sequence point of the specified method body.

Unique ID representing a method across all generations.

Delta applied to all sequence points.

Per-sequence-point deltas.

Aggregate number of unique documents in all previous generations.

The method takes ownership of the upon entry and disposes it in case of a failure to construct the reader.

Maps relative to this reader to the corresponding global . Null if handles correspond to ids 1:1 (baseline).

Maps relative to this reader to the corresponding global .

Given a metadata interface and a file name, returns the interface that will read the debugging symbols associated with the module.

This version of the function can search for the PDB in areas other than right next to the module. The search policy can be controlled by combining CorSymSearchPolicyAttributes e.g AllowReferencePathAccess|AllowSymbolServerAccess will look for the pdb next to the PE file and on a symbol server, but won't query the registry or use the path in the PE file. If a searchPath is provided, those directories will always be searched. is null or empty. does not implement IMetadataImport interface.

Creates a new for the specified PDB stream.

IMetadataImport reading metadata in PE file. PDB stream. The implementation supports Portable PDB and Embedded Portable PDB formats. The new reader instance. E_INVALIDARG doesn't implement , or doesn't implement . Another error code describing failure to read the stream.

Creates a new for the specified PDB file.

Provider of a metadata importer for the corresponding PE file. The importer is only constructed if the operation performed on the SymReader requires access to the metadata. PDB file path. The implementation supports Portable PDB format. The new reader instance. E_INVALIDARG is null, or is null or empty. Another error code describing failure to open the file.

Creates a new for the specified PDB file.

Provider of a metadata importer for the corresponding PE file. The importer is only constructed if the operation performed on the SymReader requires access to the metadata. PDB stream. The implementation supports Portable PDB and Embedded Portable PDB formats. The new reader instance. is null is null

Get the token of the local signature.

Local signature token (StandAloneSig), or 0 if the method doesn't have any local variables. S_OK if the method has a local signature, S_FALSE if the method doesn't have a local signature, E_* if an error occurs while reading the signature.

Get the file name for the line associated with specified offset.

Get the line information associated with .

If is not a sequence point it is associated with the previous one. provides the associated sequence point.

Get the number of Documents that this method has lines in.

Get the documents this method has lines in.

Get the smallest start line and largest end line, for the method, in a specific document.

Takes ownership of and .

Finds document of a specified name.

Document name. Ignored. Ignored. Ignored. Document or null. S_OK if found, S_FALSE if not found. EnC: Returns document in the first generation that defines one with matching name, even if the document is not referred to by any sequence point anymore (e.g. the statement was removed by a subsequent edit).

Get a list of all documents, including those added via EnC.

Get the latest version of a method with specified token.

Get a particular version of a method with specified token.

Checks whether the id stored in the PDB matches the PDB ID stored in the PE/COFF Debug Directory.

The GUID portion of the PDB ID from the PE/COFFF debug directory The timestamp portion of the PDB ID from the PE/COFF debug directory. If the caller doesn't have access to this value, the caller may also pass zero for this value and -1 for the age. The age value from the PE/COFF debug directory True if the PDB matches the provided PDB ID

Returns a pointer to Portable Debug Metadata. Only available for Portable PDBs.

A pointer to memory where Portable Debug Metadata start. The memory is owned by the SymReader and valid until is invoked. Null if the PDB is not portable. Size of the metadata block. S_OK if the PDB is portable, S_FALSE if it isn't. If the store was updated via returns the metadata of the latest update.

Returns a pointer to Portable Debug Metadata of the specified version (EnC generation). Only available for Portable PDBs.

EnC 1-based version number. Version 1 corresponds to the baseline. A pointer to memory where Portable Debug Metadata start. The memory is owned by the SymReader and valid until is invoked. Null if the PDB is not portable. Size of the metadata block.

Returns a pointer to Source Server data stored in the PDB.

A pointer to memory where Source Server data start. The memory is owned by the SymReader and valid until is invoked. Null if the PDB doesn't contain Source Server data. Size of the data in bytes. S_OK if the PDB contains Source Server data, S_FALSE if it doesn't.

Applies EnC edit.

Not thread safe. Must not be run in parallel with any other operation on the SymReader or objects it owns.

Gets the number of local variables of the latest version of the specified method.

Gets local variables of the latest version of the specified method.

Allows updating the line info for a method that has not been recompiled, but whose lines have moved independently. A delta for each statement is allowed.

Groups specified entries by key optimizing for single-item groups. The ordering of values within each bucket is the same as their ordering in the sequence.

Returns the position in given path where the file name starts.

-1 if path is null.

Get file name from path.

Unlike doesn't check for invalid path characters.

Provides tools for using in interop scenarios.

*** WARNING *** If you decide to copy this code elsewhere, please retain the documentation here and the Dangerous prefixes in the API names. This will help track down and audit other places where this technique (with dangerous consequences when misused) may be applied. A generic version of this API was once public in a pre-release of immutable collections, but it was deemed to be too subject to abuse when available publicly. This implementation is scoped to byte arrays as that is all that the metadata reader needs. Also, since we don't have access to immutable collection internals, we use a trick involving overlapping a with a refer. While unverifiable, it is valid. See ECMA-335, section II.10.7 Controlling instance layout: "It is possible to overlap fields in this way, though offsets occupied by an object reference shall not overlap with offsets occupied by a built-in value type or a part of another object reference. While one object reference can completely overlap another, this is unverifiable." Furthermore, the fact that backed by a single field is something inherent to the design of ImmutableArray in order to get its performance characteristics and therefore something we (Microsoft) are comfortable defining as a contract that can be depended upon as below.

Creates a new instance of using a given mutable array as the backing field, without creating a defensive copy. It is the responsibility of the caller to ensure no other mutable references exist to the array. Do not mutate the array after calling this method.

The mutable array to use as the backing field. The incoming reference is set to null since it should not be retained by the caller. Users of this method should take extra care to ensure that the mutable array given as a parameter is never modified. The returned will use the given array as its backing field without creating a defensive copy, so changes made to the given mutable array will be observable on the returned . Instance and static methods of and may malfunction if they operate on an instance whose underlying backing field is modified. An immutable array.

Access the backing mutable array instance for the given , without creating a defensive copy. It is the responsibility of the caller to ensure the array is not modified through the returned mutable reference. Do not mutate the returned array.

The from which to retrieve the backing field. Users of this method should take extra care to ensure that the returned mutable array is never modified. The returned mutable array continues to be used as the backing field of the given without creating a defensive copy, so changes made to the returned mutable array will be observable on the given . Instance and static methods of and may malfunction if they operate on an instance whose underlying backing field is modified. The underlying array, or null if is true.

Find a instance by first probing the contract name and then the name as it would exist in mscorlib. This helps satisfy both the CoreCLR and Desktop scenarios.

Attempts to read all of the requested bytes from the stream into the buffer

The number of bytes read. Less than will only be returned if the end of stream is reached before all bytes can be read. Unlike it is not guaranteed that the stream position or the output buffer will be unchanged if an exception is returned.