Glasswall Document Processing - Supporting Functions

These functions may be used alongside the document processing functions for additional support on certain aspects or attributes such as determining the file extension for a given file.

For every function that relies on an input file, it is the responsibility of the client application to ensure that the folder containing the specified file location exists. If the containing folder does not exist, or 'read privileges' are not enabled, the processing function will return an error status.

Functions

• int GWDetermineFileTypeFromFileInMem (void *inputBuffer, size_t inputBufferSize)
• int GWDetermineFileTypeFromFileInMemAndReport (void *inputBuffer, size_t inputBufferSize, void **reportFileBuffer, size_t *reportFileBufferLength)
• int GWDetermineFileTypeFromFile (const wchar_t *inputFilePathName)
• int GWDetermineFileTypeFromFileAndReport (const wchar_t *inputFilePathName, void **reportFileBuffer, size_t *reportFileBufferLength)

GWDetermineFileTypeFromFile

int GWDetermineFileTypeFromFile (const wchar_t * inputFilePathName)

This function determines the file type for a given file provided it is supported by Glasswall.

Parameters

Returns

• File Type Enumeration

Remarks

Glasswall GWDetermineFileTypeFromFile example.

// Input file path, managed file output buffer and length
const wchar_t* inputFilePath = L"C:\\data\\temp1.pdf";
void *fileImage              = NULL;
size_t fileImageLength	      = 0;

// Library configuration
wchar_t* cmPolicy = getClientApplicationConfigurationXML();

if (eGwFileStatus_Success == GWFileConfigXML(cmPolicy))
{
    wchar_t* fileType = NULL; 
    int eFileType     = 0;

    // Determine the file type
    eFileType = GWDetermineFileTypeFromFile(inputFilePath);

    switch (eFileType)
{
        case 16:
            fileType = L"pdf"; break;

        case 17:
            fileType = L"doc"; break;

        ...

        case 27:
            fileType = L"wmf"; break;
    }

    if (fileType)
    {
        // Call Glasswall processing function
        if(GWFileProtect(inputFilePath, fileType, &fileImage, &fileImageLength))

        {
            // Process the managed file image
        }
    }
    else
    {
        // Error handling
    }
}
else
{
    // Error handling
}

// Release resources including the global buffers 
GWFileDone();

GWDetermineFileTypeFromFileAndReport

int GWDetermineFileTypeFromFileAndReport (const wchar_t * inputFilePathName, void ** reportFileBuffer, size_t * reportFileBufferLength)

This function determines the file type for a given file provided it is supported by Glasswall, it also populates an XML report with the approach used to determine the file type.

Parameters

Returns

• File Type Enumeration

Remarks

Glasswall GWDetermineFileTypeFromFile example.

// Input file path, managed file output buffer and length
const wchar_t* inputFilePath    = L"C:\\data\\temp1.pdf";

void *analysisFileBuffer        = NULL;
size_t analysisFileBufferLength = 0;

void *fileImage                 = NULL;
size_t fileImageLength          = 0;

// Library configuration
wchar_t* cmPolicy = getClientApplicationConfigurationXML();

if (eGwFileStatus_Success == GWFileConfigXML(cmPolicy))
{
    wchar_t* fileType = NULL;
    int eFileType     = 0;

    // Determine the file type
    eFileType = GWDetermineFileTypeFromFileAndReport(inputFilePath, 
&analysisFileBuffer, &analysisFileBufferLength);

    switch (eFileType)
    {
        case 16:
            fileType = L"pdf"; break;

        case 17:
            fileType = L"doc"; break;

        ...

        case 27:
            fileType = L"wmf"; break;  
    }

    if (fileType)
    {
        // Call Glasswall processing function
        if(GWFileProtect(inputFilePath, fileType, &fileImage, &fileImageLength))
        {
            // Process the managed file image
         // Report file type detection approach using content in analysisFileBuffer
        }
    }
    else
    {
        // Error handling
    }
}
else
{
    // Error handling
}

// Release resources including the global buffers 
GWFileDone();

GWDetermineFileTypeFromFileInMem

int GWDetermineFileTypeFromFileInMem (void * inputBuffer, size_t inputBufferSize)

This function determines the file type for a file stored in memory provided that the file type is supported by Glasswall.

Parameters

Returns

• File Type Enumeration

Remarks

Glasswall GWDetermineFileTypeFromFileInMem example.

// input file buffer and length

void *inputFileBuffer    = NULL;
size_t inputFileLength   = 0;

// output buffer and length 
void *outputFileBuffer   = NULL;
size_t outputFileLength  = 0;

// load file from a memory location
if (eGwFileStatus_Success == LoadFileFromMemory(&inputFileBuffer, 
&inputFileLength))
{
    // Library configuration
    wchar_t* cmPolicy = getClientApplicationConfigurationXML();

    if (eGwFileStatus_Success == GWFileConfigXML(cmPolicy))
    {
        wchar_t* fileType = NULL; 
        int eFileType     = 0;

        // Determine the file type
        eFileType = GWDetermineFileTypeFromFileInMem(inputFileBuffer,
 inputFileLength);

        switch (eFileType)
       {
            case 16:
            fileType = L"pdf"; 
            break;

            case 17:
            fileType = L"doc"; 
            break;
        ...

            case 27:
            fileType = L"wmf";
            break;
        }

        if (fileType)
        {
            // Call Glasswall processing function
            if(GWMemoryToMemoryProtect(inputFileBuffer, inputFileLength,
            fileType, &fileImage, &fileImageLength))
            {
                // Process the managed file image
            } 
        }
        else
        {
            // Error handling
        }
    }  
    else
    {
        // Error handling
    }

        // free memory allocated by LoadFileFromMemory 
        gwFree(inputFileBuffer);
}
else
{
// Error handling
}

// Release resources including the global buffers 
GWFileDone();

GWDetermineFileTypeFromFileInMemAndReport

int GWDetermineFileTypeFromFileInMemAndReport (void * inputBuffer, size_t inputBufferSize, void ** reportFileBuffer, size_t * reportFileBufferLength)

This function determines the file type for a given file provided it is supported by Glasswall, it also populates an XML report with the approach used to determine the file type.

Parameters

Returns

• File Type Enumeration

Remarks

Glasswall GWDetermineFileTypeFromFileInMemAndReport example.

// input file buffer and length 
void *inputFileBuffer              = NULL;
size_t inputFileLength             = 0;

// determine file type output buffer and length 
void *fileTypeReportBuffer         = NULL; 
size_t fileTypeReportBufferLength  = 0;

// output file buffer and length
void *outputFileBuffer             = NULL;
size_t outputFileLength            = 0;

// load file from a memory location
if (eGwFileStatus_Success == LoadFileFromMemory(&inputFileBuffer, 
&inputFileLength))
{
    // Library configuration
    wchar_t* cmPolicy = getClientApplicationConfigurationXML();

    if (eGwFileStatus_Success == GWFileConfigXML(cmPolicy))  
    {
        wchar_t* fileType  = NULL; 
        int eFileType      = 0;

        // Determine the file type
        eFileType = GWDetermineFileTypeFromFileInMemAndReport(inputFileBuffer, 
inputFileLength, &fileTypeReportBuffer, &fileTypeReportBufferLength);

        switch (eFileType) 
        {
            case 16:
                fileType = L"pdf"; 
                break;

            case 17:
                fileType = L"doc"; 
                break;
            ...

            case 27:
                fileType = L"wmf"; 
                break;
        }

        if (fileType)
        {
            // Call Glasswall processing function 
            if(GWMemoryToMemoryProtect(inputFileBuffer, inputFileLength,
fileType, &fileImage, &fileImageLength))
            {
                // Process the managed file image
            }
        }
        else
        {
            // Error handling
        }

        // Process xml report from GWDetermineFileTypeFromFileInMemAndReport 
stored in fileTypeReportBuffer
    }
    else
    {
        // Error handling
    }

    // free memory allocated by LoadFileFromMemory 
    gwFree(inputFileBuffer);
}
else
{
// Error handling
}

// Release resources including the global buffers 
GWFileDone();