Component:

S_Get_Content

Part of C_WissDB_DL_API

Abstract:

Given a locator X in use, this is the function to ask the B_WissDB_Database for the content that is referred to as the value of unit( X ).

Parameters:

§      In: Locator

        Is to be a D_Locator currently in use.

§      In: storeAt

        Is to be the B_URL to the file that shall be created or re-created to represent a copy of the content addresses by the Locator (in case of content value NULL this file, if existing, is to be deleted).

§      Out: Content

        Is either NULL or a the B_URL to a file just created or re-created to represent the content addressed by the given Locator.

§      Out: AppErrors

        Is to describe an AppError

–      if the given Locator is not in use

–      or if storeAt could not be created (if the Content is not NULL)

–      or if storeAt could not be destroyed (if the Content is NULL).

§      Out: ReturnCode is one of the following values:

–      RC_ok

–      RC_syserror

–      RC_seeAppErrors

Has to:

Retrieve the content addressed by the given Locator (or – if this content is NULL – ensure that the file or folder storeAt does not exist any more).

Because of:

C_WissDB_API needs a way to retrieve the value of unit( X ), X a locator in use.