Docs » Autodocs » dos.library » AllocDosObject
AllocDosObject -- Creates a dos object (V36)
ptr = AllocDosObject(type, tags)
D0 D1 D2
void *AllocDosObject(ULONG, struct TagItem *)
ptr = AllocDosObjectTagList(type, tags)
D0 D1 D2
void *AllocDosObjectTagList(ULONG, struct TagItem *)
ptr = AllocDosObjectTags(type, Tag1, ...)
void *AllocDosObjectTags(ULONG, ULONG, ...)
Create one of several dos objects, initializes it, and returns it
to you. Note the DOS_STDPKT returns a pointer to the sp_Pkt of the
structure.
This function may be called by a task for all types and tags defined
in the V37 includes (DOS_FILEHANDLE through DOS_RDARGS and ADO_FH_Mode
through ADO_PromptLen, respectively). Any future types or tags
will be documented as to whether a task may use them.
type - type of object requested
tags - pointer to taglist with additional information
packet - pointer to the object or NULL
Before V39, DOS_CLI should be used with care since FreeDosObject()
can't free it.
FreeDosObject(), <dos/dostags.h>, <dos/dos.h>
|
