OS/2 File Manager API Differences

The following describes the implementation differences between the OS2Linux library and the real OS/2 File Manager APIs.

These APIs are included in your application by including the following definition in your application source file.

#define INCL_DOSFILEMGR

DosOpen

APIRET APIENTRY DosOpen(PSZ pszFileName, PHFILE pHf, PULONG pulAction,
                        ULONG cbFile, ULONG ulAttribute, ULONG fsOpenFlags,
                        ULONG fsOpenMode, PEAOP2 peaop2);

All backslash (\) characters are translated to forwardslash(/) characters in the argument pszFileName automatically.
If a drive specifier is found in the pszFileName then the function will return ERROR_INVALID_PARAMETER.
Named pipes are always opened in byte mode. Message mode is not supported.
Network named pipes of the form \\srvname\pipe are not supported.
A lot of flags are not checked in the arguments ulAttribute, fsOpenFlags and fsOpenMode.
The argument peaop2 is ignored.

DosClose

APIRET APIENTRY DosClose(HFILE hFile);

None.

DosRead

APIRET APIENTRY DosRead(HFILE hFile, PVOID pBuffer, ULONG cbRead,
                        PULONG pcbActual);

None.

DosWrite

APIRET APIENTRY DosWrite(HFILE hFile, PVOID pBuffer, ULONG cbWrite,
                         PULONG pcbActual);

None.

DosDelete

APIRET APIENTRY DosDelete(PSZ pszFile);

None.

DosForceDelete

APIRET APIENTRY DosForceDelete(PSZ pszFile);

None.

DosDupHandle

APIRET APIENTRY DosDupHandle(HFILE hFile, PHFILE pHfile);

None.

DosQueryFHState

APIRET APIENTRY DosQueryFHState(HFILE hFile, PULONG pMode);

None.

DosSetFHState

APIRET APIENTRY DosSetFHState(HFILE hFile, ULONG mode);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosQueryHType

APIRET APIENTRY DosQueryHType(HFILE hFile, PULONG pType, PULONG pAttr);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosFindFirst

APIRET APIENTRY DosFindFirst(PSZ pszFileSpec, PHDIR phdir, ULONG flAttribute,
                             PVOID pfindbuf, ULONG cbBuf, PULONG pcFileNames,
                             ULONG ulInfoLevel);

The argument flAttribute is ignored.
The argument ulInfoLevel must be FIL_STANDARD.
Added the return code ERROR_NOT_ENOUGH_MEMORY.

DosFindNext

APIRET APIENTRY DosFindNext(HDIR hDir, PVOID pfindbuf, ULONG cbfindbuf,
                            PULONG pcFilenames);

None.

DosFindClose

APIRET APIENTRY DosFindClose(HDIR hDir);

None.

DosFSAttach

APIRET APIENTRY DosFSAttach(PSZ pszDevice, PSZ pszFilesystem, PVOID pData,
                            ULONG cbData, ULONG flag);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosQueryFSAttach

APIRET APIENTRY DosQueryFSAttach(PSZ pszDeviceName, ULONG ulOrdinal,
                                 ULONG ulFSAInfoLevel, PFSQBUFFER2 pfsqb,
                                 PULONG pcbBuffLength);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosFSCtl

APIRET APIENTRY DosFSCtl(PVOID pData, ULONG cbData, PULONG pcbData,
                         PVOID pParms, ULONG cbParms, PULONG pcbParms,
                         ULONG function, PSZ pszRoute, HFILE hFile,
                         ULONG method);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosSetFileSize

APIRET APIENTRY DosSetFileSize(HFILE hFile, ULONG cbSize);

None.

DosResetBuffer

APIRET APIENTRY DosResetBuffer(HFILE hFile);

None.

DosSetFilePtr

APIRET APIENTRY DosSetFilePtr(HFILE hFile, LONG ib, ULONG method,
                              PULONG ibActual);

None.

DosMove

APIRET APIENTRY DosMove(PSZ pszOld, PSZ pszNew);

None.

DosCopy

APIRET APIENTRY DosCopy(PSZ pszOld, PSZ pszNew, ULONG option);

Added the return code ERROR_NOT_ENOUGH_MEMORY.

DosEditName

APIRET APIENTRY DosEditName(ULONG metalevel, PSZ pszSource, PSZ pszEdit,
                            PBYTE pszTarget, ULONG cbTarget);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosCreateDir

APIRET APIENTRY DosCreateDir(PSZ pszDirName, PEAOP2 peaop2);

The argument peaop2 is ignored.

DosDeleteDir

APIRET APIENTRY DosDeleteDir(PSZ pszDir);

None.

DosSetDefaultDisk

APIRET APIENTRY DosSetDefaultDisk(ULONG disknum);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosQueryCurrentDisk

APIRET APIENTRY DosQueryCurrentDisk(PULONG pdisknum, PULONG plogical);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosSetCurrentDir

APIRET APIENTRY DosSetCurrentDir(PSZ pszDir);

None.

DosQueryCurrentDir

APIRET APIENTRY DosQueryCurrentDir(ULONG disknum, PBYTE pBuf, PULONG pcbBuf);

None.

DosQueryFSInfo

APIRET APIENTRY DosQueryFSInfo(ULONG disknum, ULONG infolevel, PVOID pBuf,
                               ULONG cbBuf);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosSetFSInfo

APIRET APIENTRY DosSetFSInfo(ULONG disknum, ULONG infolevel, PVOID pBuf,
                             ULONG cbBuf);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosQueryVerify

APIRET APIENTRY DosQueryVerify(PBOOL32 pBool);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosSetVerify

APIRET APIENTRY DosSetVerify(BOOL32 verify);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosSetMaxFH

APIRET APIENTRY DosSetMaxFH(ULONG cFH);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosSetRelMaxFH

APIRET APIENTRY DosSetRelMaxFH(PLONG pcbReqCount, PULONG pcbCurMaxFH);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosQueryFileInfo

APIRET APIENTRY DosQueryFileInfo(HFILE hf, ULONG ulInfoLevel, PVOID pInfo,
                                 ULONG cbInfoBuf);

The argument ulInfoLevel must be FIL_STANDARD.

DosSetFileInfo

APIRET APIENTRY DosSetFileInfo(HFILE hf, ULONG ulInfoLevel, PVOID pInfoBuf,
                               ULONG cbInfoBuf);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosQueryPathInfo

APIRET APIENTRY DosQueryPathInfo(PSZ pszPathName, ULONG ulInfoLevel,
                                 PVOID pInfo, ULONG cbInfoBuf);

The argument ulInfoLevel must be FIL_STANDARD.

DosSetPathInfo

APIRET APIENTRY DosSetPathInfo(PSZ pszPathName, ULONG ulInfoLevel,
                               PVOID pInfoBuf, ULONG cbInfoBuf, ULONG flOptions);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosShutdown

APIRET APIENTRY DosShutdown(ULONG ulReserved);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosEnumAttribute

APIRET APIENTRY DosEnumAttribute(ULONG ulRefType, PVOID pvFile, ULONG ulEntry,
                                 PVOID pvBuf, ULONG cbBuf, PULONG pulCount,
                                 ULONG ulInfoLevel);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosSetFileLocks

APIRET APIENTRY DosSetFileLocks(HFILE hFile, PFILELOCK pflUnlock,
                                PFILELOCK pflLock, ULONG timeout, ULONG flags);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosCancelLockRequest

APIRET APIENTRY DosCancelLockRequest(HFILE hFile, PFILELOCK pflLock);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosProtectEnumAttribute

APIRET APIENTRY DosProtectEnumAttribute(ULONG ulRefType, PVOID pvFile,
                                        ULONG ulEntry, PVOID pvBuf, ULONG cbBuf,
                                        PULONG pulCount, ULONG ulInfoLevel,
                                        FHLOCK fhFileHandleLockID );

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosProtectSetFileLocks

APIRET APIENTRY DosProtectSetFileLocks(HFILE hFile, PFILELOCK pflUnlock,
                                       PFILELOCK pflLock, ULONG timeout,
                                       ULONG flags, FHLOCK fhFileHandleLockID);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosProtectOpen

APIRET APIENTRY DosProtectOpen(PSZ pszFileName, PHFILE phf, PULONG pulAction,
                               ULONG cbFile, ULONG ulAttribute,
                               ULONG fsOpenFlags, ULONG fsOpenMode,
                               PEAOP2 peaop2, PFHLOCK pfhFileHandleLockID);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosProtectClose

APIRET APIENTRY DosProtectClose(HFILE hFile, FHLOCK fhFileHandleLockID);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosProtectRead

APIRET APIENTRY DosProtectRead(HFILE hFile, PVOID pBuffer, ULONG cbRead,
                               PULONG pcbActual, FHLOCK fhFileHandleLockID);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosProtectWrite

APIRET APIENTRY  DosProtectWrite(HFILE hFile, PVOID pBuffer, ULONG cbWrite,
                                 PULONG pcbActual, FHLOCK fhFileHandleLockID);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosProtectQueryFHState

APIRET APIENTRY DosProtectQueryFHState(HFILE hFile, PULONG pMode,
                                       FHLOCK fhFileHandleLockID);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosProtectSetFHState

APIRET APIENTRY DosProtectSetFHState(HFILE hFile, ULONG mode,
                                     FHLOCK fhFileHandleLockID);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosProtectSetFileSize

APIRET APIENTRY DosProtectSetFileSize(HFILE hFile, ULONG cbSize,
                                      FHLOCK fhFileHandleLockID);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosProtectSetFilePtr

APIRET APIENTRY DosProtectSetFilePtr(HFILE hFile, LONG ib, ULONG method,
                                     PULONG ibActual, FHLOCK fhFileHandleLockID);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosProtectQueryFileInfo

APIRET APIENTRY DosProtectQueryFileInfo(HFILE hf, ULONG ulInfoLevel,
                                        PVOID pInfo, ULONG cbInfoBuf,
                                        FHLOCK fhFileHandleLockID);

This function is not supported and always returns ERROR_ACCESS_DENIED.

DosProtectSetFileInfoo

APIRET APIENTRY DosProtectSetFileInfo(HFILE hf, ULONG ulInfoLevel,
                                      PVOID pInfoBuf, ULONG cbInfoBuf,
                                      FHLOCK fhFileHandleLockID);

This function is not supported and always returns ERROR_ACCESS_DENIED.