ISymUnmanagedWriter::Initialize Method

Sets the metadata emitter interface with which this writer will be associated, and sets the output file name to which the debugging symbols will be written.

This method can be called only once, and it must be called before any other writer methods. Some writers may require a file name. However, you can always pass a file name to this method without any negative effect on writers that do not use the file name.

Syntax

HRESULT Initialize(  
    [in] IUnknown     *emitter,  
    [in] const WCHAR  *filename,  
    [in] IStream      *pIStream,  
    [in] BOOL         fFullBuild);  

Parameters

emitter
[in] A pointer to the metadata emitter interface.

filename
[in] The file name to which the debugging symbols are written. If a file name is specified for a writer that does not use file names, this parameter is ignored.

pIStream
[in] If specified, the symbol writer will emit the symbols into the given IStream rather than to the file specified in the filename parameter. The pIStream parameter is optional.

fFullBuild
[in] true if this is a full rebuild; false if this is an incremental compilation.

Return Value

S_OK if the method succeeds; otherwise, E_FAIL or some other error code.

Requirements

Header: CorSym.idl, CorSym.h

See also