ICeeFileGen Class

Provides functionality for creating a native portable executable (PE) file. The interface will typically be used by compilers to generate their compiled output executable.

Note:
ICeeFileGen supports the .NET Framework infrastructure and is not intended to be used directly from your code.

This interface has been deprecated and will be removed in a future release.

class ICeeFileGen {
public:
    virtual HRESULT CreateCeeFile(HCEEFILE *ceeFile);

    virtual HRESULT EmitMetaData (HCEEFILE ceeFile,
        IMetaDataEmit *emitter, mdScope scope);

    virtual HRESULT EmitLibraryName (HCEEFILE ceeFile,
        IMetaDataEmit *emitter, mdScope scope);

    virtual HRESULT EmitMethod ();

    virtual HRESULT GetMethodRVA (HCEEFILE ceeFile,
        ULONG codeOffset, ULONG *codeRVA);

    virtual HRESULT EmitSignature ();

    virtual HRESULT EmitString (HCEEFILE ceeFile,
        __in LPWSTR strValue, ULONG *strRef);

    virtual HRESULT GenerateCeeFile (HCEEFILE ceeFile);

    virtual HRESULT SetOutputFileName (HCEEFILE ceeFile,
        __in LPWSTR outputFileName);

    virtual HRESULT GetOutputFileName (HCEEFILE ceeFile,
        __out LPWSTR *outputFileName);

    virtual HRESULT SetResourceFileName (HCEEFILE ceeFile,
        __in LPWSTR resourceFileName);

    virtual HRESULT GetResourceFileName (HCEEFILE ceeFile,
        __out LPWSTR *resourceFileName);

    virtual HRESULT SetImageBase(HCEEFILE ceeFile, size_t imageBase);

    virtual HRESULT SetSubsystem(HCEEFILE ceeFile, DWORD subsystem,
        DWORD major, DWORD minor);

    virtual HRESULT SetEntryClassToken ();

    virtual HRESULT GetEntryClassToken ();

    virtual HRESULT SetEntryPointDescr ();

    virtual HRESULT GetEntryPointDescr ();

    virtual HRESULT SetEntryPointFlags ();

    virtual HRESULT GetEntryPointFlags ();

    virtual HRESULT SetDllSwitch (HCEEFILE ceeFile, BOOL dllSwitch);

    virtual HRESULT GetDllSwitch (HCEEFILE ceeFile, BOOL *dllSwitch);

    virtual HRESULT SetLibraryName (HCEEFILE ceeFile,
        __in LPWSTR LibraryName);

    virtual HRESULT GetLibraryName (HCEEFILE ceeFile,
        __out LPWSTR *LibraryName);

    virtual HRESULT SetLibraryGuid (HCEEFILE ceeFile,
        __in LPWSTR LibraryGuid);

    virtual HRESULT DestroyCeeFile(HCEEFILE *ceeFile);

    virtual HRESULT GetSectionCreate (HCEEFILE ceeFile,
        const char *name, DWORD flags, HCEESECTION *section);

    virtual HRESULT GetIlSection (HCEEFILE ceeFile,
        HCEESECTION *section);

    virtual HRESULT GetRdataSection (HCEEFILE ceeFile,
        HCEESECTION *section);

    virtual HRESULT GetSectionDataLen (HCEESECTION section,
        ULONG *dataLen);

    virtual HRESULT GetSectionBlock (HCEESECTION section, ULONG len,
        ULONG align=1, void **ppBytes=0);

    virtual HRESULT TruncateSection (HCEESECTION section, ULONG len);

    virtual HRESULT AddSectionReloc (HCEESECTION section,
        ULONG offset, HCEESECTION relativeTo,
        CeeSectionRelocType relocType);

    virtual HRESULT SetSectionDirectoryEntry (HCEESECTION section,
        ULONG num);

    virtual HRESULT CreateSig ();

    virtual HRESULT AddSigArg ();

    virtual HRESULT SetSigReturnType ();

    virtual HRESULT SetSigCallingConvention ();

    virtual HRESULT DeleteSig ();

    virtual HRESULT SetEntryPoint (HCEEFILE ceeFile,
        mdMethodDef method);

    virtual HRESULT GetEntryPoint (HCEEFILE ceeFile,
        mdMethodDef *method);

    virtual HRESULT SetComImageFlags (HCEEFILE ceeFile, DWORD mask);

    virtual HRESULT GetComImageFlags (HCEEFILE ceeFile, DWORD *mask);

    virtual HRESULT GetIMapTokenIface(HCEEFILE ceeFile,
        IMetaDataEmit *emitter, IUnknown **pIMapToken);

    virtual HRESULT SetDirectoryEntry (HCEEFILE ceeFile,
        HCEESECTION section, ULONG num, ULONG size, ULONG offset = 0);

    virtual HRESULT EmitMetaDataEx (HCEEFILE ceeFile,
        IMetaDataEmit *emitter); 

    virtual HRESULT EmitLibraryNameEx (HCEEFILE ceeFile,
        IMetaDataEmit *emitter);

    virtual HRESULT GetIMapTokenIfaceEx(HCEEFILE ceeFile,
        IMetaDataEmit *emitter, IUnknown **pIMapToken);

    virtual HRESULT EmitMacroDefinitions(HCEEFILE ceeFile,
        void *pData, DWORD cData);

    virtual HRESULT CreateCeeFileFromICeeGen(ICeeGen *pFromICeeGen,
        HCEEFILE *ceeFile, DWORD createFlags =
        ICEE_CREATE_FILE_PURE_IL);

    virtual HRESULT SetManifestEntry(HCEEFILE ceeFile, ULONG size,
        ULONG offset);

    virtual HRESULT SetEnCRVABase(HCEEFILE ceeFile, ULONG dataBase,
        ULONG rdataBase);

    virtual HRESULT GenerateCeeMemoryImage (HCEEFILE ceeFile,
        void **ppImage);

    virtual HRESULT ComputeSectionOffset(HCEESECTION section,
        __in char *ptr, unsigned *offset);

    virtual HRESULT ComputeOffset(HCEEFILE file, __in char *ptr,
        HCEESECTION *pSection, unsigned *offset);

    virtual HRESULT GetCorHeader(HCEEFILE ceeFile,
        IMAGE_COR20_HEADER **header);

    virtual HRESULT LinkCeeFile (HCEEFILE ceeFile);

    virtual HRESULT FixupCeeFile (HCEEFILE ceeFile);

    virtual HRESULT GetSectionRVA (HCEESECTION section, ULONG *rva);

    virtual HRESULT ComputeSectionPointer(HCEESECTION section,
        ULONG offset, __out char **ptr);

    virtual HRESULT SetObjSwitch (HCEEFILE ceeFile, BOOL objSwitch);

    virtual HRESULT GetObjSwitch (HCEEFILE ceeFile, BOOL *objSwitch);

    virtual HRESULT SetVTableEntry(HCEEFILE ceeFile, ULONG size,
        ULONG offset);

    virtual HRESULT SetStrongNameEntry(HCEEFILE ceeFile, ULONG size,
        ULONG offset);

    virtual HRESULT EmitMetaDataAt (HCEEFILE ceeFile,
        IMetaDataEmit *emitter, HCEESECTION section, DWORD offset,
        BYTE* buffer, unsigned buffLen);

    virtual HRESULT GetFileTimeStamp (HCEEFILE ceeFile,
        DWORD *pTimeStamp);

    virtual HRESULT AddNotificationHandler(HCEEFILE ceeFile,
        IUnknown *pHandler);

    virtual HRESULT SetFileAlignment(HCEEFILE ceeFile,
        ULONG fileAlignment);

    virtual HRESULT ClearComImageFlags (HCEEFILE ceeFile, DWORD mask);

    virtual HRESULT CreateCeeFileEx(HCEEFILE *ceeFile,
        ULONG createFlags);

    virtual HRESULT SetImageBase64(HCEEFILE ceeFile,
        ULONGLONG imageBase);

    virtual HRESULT GetHeaderInfo (HCEEFILE ceeFile,
        PIMAGE_NT_HEADERS *ppNtHeaders,
        PIMAGE_SECTION_HEADER *ppSections, ULONG *pNumSections);

    virtual HRESULT CreateCeeFileEx2(HCEEFILE *ceeFile,
        ULONG createFlags, LPCWSTR seedFileName = NULL);

    virtual HRESULT SetVTableEntry64(HCEEFILE ceeFile, ULONG size,
        void* ptr);
};

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: ICeeFileGen.h

.NET Framework Version: 1.0

See Also

Concepts

Hosting Interfaces