SQL Server

Find a ZIP Entry by Exact Path Using EntryOf

See more Zip Examples

This example demonstrates how to use the EntryOf method to find a ZIP entry whose stored path exactly matches a specified path.

Unlike EntryMatching, which performs wildcard matching, EntryOf performs an exact path lookup.

This method is useful when:

• The exact ZIP path is already known
• Retrieving a specific file or directory entry
• Verifying whether a particular entry exists in the ZIP archive

Suppose the ZIP archive contains:

docs/
docs/readme.txt
docs/manual.pdf
images/logo.png
data/config/settings.json

ZIP archives may optionally contain explicit directory entries such as docs/. These directory entries can also be retrieved using EntryOf.

The example:

• Finds an exact file entry
• Finds an exact directory entry
• Demonstrates the difference between file and directory entries

SQL Server

-- Important: See this note about string length limitations for strings returned by sp_OAMethod calls.
--
CREATE PROCEDURE ChilkatSample
AS
BEGIN
    DECLARE @hr int
    DECLARE @iTmp0 int
    -- Important: Do not use nvarchar(max).  See the warning about using nvarchar(max).
    DECLARE @sTmp0 nvarchar(4000)
    DECLARE @success int
    SELECT @success = 0

    -- This example assumes the Chilkat API to have been previously unlocked.
    -- See Global Unlock Sample for sample code.

    SELECT @success = 0

    -- Open an existing ZIP archive.
    DECLARE @zip int
    EXEC @hr = sp_OACreate 'Chilkat.Zip', @zip OUT
    IF @hr <> 0
    BEGIN
        PRINT 'Failed to create ActiveX component'
        RETURN
    END

    EXEC sp_OAMethod @zip, 'OpenZip', @success OUT, 'example.zip'
    IF @success = 0
      BEGIN
        EXEC sp_OAGetProperty @zip, 'LastErrorText', @sTmp0 OUT
        PRINT @sTmp0
        EXEC @hr = sp_OADestroy @zip
        RETURN
      END

    DECLARE @entry int
    EXEC @hr = sp_OACreate 'Chilkat.ZipEntry', @entry OUT

    -- ------------------------------------------------------------
    -- Find a specific file entry by its exact ZIP path.

    EXEC sp_OAMethod @zip, 'EntryOf', @success OUT, 'docs/readme.txt', @entry

    IF @success = 1
      BEGIN

        PRINT 'Found file entry:'

        EXEC sp_OAGetProperty @entry, 'FileName', @sTmp0 OUT
        PRINT '  FileName = ' + @sTmp0

        EXEC sp_OAGetProperty @entry, 'IsDirectory', @iTmp0 OUT
        PRINT '  IsDirectory = ' + @iTmp0

        PRINT ''
      END

    -- ------------------------------------------------------------
    -- Find a directory entry.
    -- 
    -- ZIP archives may optionally contain explicit directory entries.
    -- In this example, "docs/" is a separate directory entry.

    EXEC sp_OAMethod @zip, 'EntryOf', @success OUT, 'docs/', @entry

    IF @success = 1
      BEGIN

        PRINT 'Found directory entry:'

        EXEC sp_OAGetProperty @entry, 'FileName', @sTmp0 OUT
        PRINT '  FileName = ' + @sTmp0

        EXEC sp_OAGetProperty @entry, 'IsDirectory', @iTmp0 OUT
        PRINT '  IsDirectory = ' + @iTmp0

        PRINT ''
      END

    -- ------------------------------------------------------------
    -- Attempt to find a non-existent entry.

    EXEC sp_OAMethod @zip, 'EntryOf', @success OUT, 'images/missing.png', @entry

    IF @success = 0
      BEGIN

        PRINT 'The entry images/missing.png was not found.'
      END

    EXEC sp_OAMethod @zip, 'CloseZip', NULL


    PRINT 'Done.'

    EXEC @hr = sp_OADestroy @zip
    EXEC @hr = sp_OADestroy @entry


END
GO