The HPFS386GetInfo API retrieves information about whether 386 HPFS and local security are installed and running on a particular drive.

An application using this API must be linked to the dynamic link library (DLL) HPFS386.DLL. It is recommended that you link your application dynamically to this DLL. When you do this, make sure HPFS386.DLL is installed on the same workstation as your application. Otherwise, load and call this DLL during program load, thereby allowing your application to run on workstations where the DLL is not installed.

The HPFS386GetInfo API exports two additional levels of information using HPFS386.DLL. Level 1 exports drive-specific information. Level 2 exports system-wide information and is equivalent to the CACHE386 /STATS command. The header file, HPFS386.H, describes each level's structure.

Restrictions

This API can be called only from an OS/2 workstation. This API does not have any access authority requirements.
Syntax

#include <hpfs386.h>
#include <netcons.h>
 
HPFS386GetInfo16(pReserved, pszInfo, sLevel,
           buf, usBuflen, pusBytesAvail);    /* 16 bit */
 
HPFS386GetInfo(pReserved, pszInfo, ulLevel,
           buf, ulBuflen, pusBytesAvail);    /* 32 bit */

Parameters

See Common Parameter Definitions for descriptions of parameters not defined here.

pReserved

(unsigned char LSFAR *) must be null.
pszInfo
(unsigned char LSFAR *) is reserved and must be null.
sLevel or ulLevel
(16-bit short or 32-bit unsigned long) must be 0, specifying the data structure described in 386-HPFS Information Data Structure.
Return Codes

The following table lists the return codes most significant to this API. (See API Return Codes for a complete list of return codes.) ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÂÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ¿³SYMBOLICCONSTANT ³VALUE³MEANING ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ NERR_Success ³ 0 ³ No errors were encountered. ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ ERROR_INVALID_PARAMETER ³ 87 ³ At least one parameter value is not valid. ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ ERROR_INVALID_LEVEL ³ 124 ³ The sLevel parameter is not valid. ³
ÃÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÅÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´
³ NERR_BufTooSmall ³ 2123 ³ The buffer is too small for fixed-length ³
³ ³ ³ data. ³
ÀÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÁÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ


---

[Back] [Next]