[Contents] [Index] [Help] [Retrace] [browse <] [Browse >]


NAME
    AllocFileRequest -- allocates a filerequester structure (v36)

SYNOPSIS
    request = AllocFileRequest()
    D0

    struct filerequester *request;

FUNCTION
    Creates and initializes the data structure required to pass to the
    requestfile() function.

INPUTS
    None.  If you wish to get other than default values, you can use
    allocaslrequest() to set up a file request with tag items.

RESULT
    Pointer to a struct filerequester, which is to be passed to the
    requestfile() function.

    The returned filerequester pointer has public fields which are
    readable by the application as defined in aslbase.h.

CAUTION
    The application MUST use either the AllocFileRequest(), or
    allocaslrequest(), function to allocate the structure to be passed to
    the FileRequest() or aslrequest() functions; it is not possible to
    create a struct FileRequest except through the library calls.

    Also, any modifications MUST be done through tagitem values, rather
    than directly modifying, unless explicitly documented otherwise.

SEE ALSO
    requestfile(), freeaslrequest(), aslrequest()