NetDASDEnum or Net32DASDEnum

The NetDASDEnum API returns a list of directories that have had directory limits applied to them. It returns other related information, such as the limit applied to each directory, the space used, and the alert and incremental threshold values for each directory. Before this API can be invoked, directory limits must be enabled on the 386-HPFS drive. (For details, see 386-HPFS and Administration - NetDASDCtl.)

Restrictions

This API can be called from DLS and OS/2 workstations, but DLS workstations can issue this call only to a remote LAN Server workstation. This API does not have any access authority requirements. However, users can only get information for the directory resources they have been granted access to.

#include <neterr.h>
#include <dasd.h>
 
NetDASDEnum(pszServername, pszDirPath,
            sIncludeSubdirs, sLevel, buf, usBuflen,
            pusEntriesReturned, pusEntriesAvail);    /* 16 bit */
 
Net32DASDEnum(pszServername, pszDirPath,
            sIncludeSubdirs, ulLevel, buf, ulBuflen,
            pulEntriesReturned, pulEntriesAvail);    /* 32 bit */

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

pszDirPath

Note: If a redirected drive is specified for pszDirPath, pszServername must be a NULL pointer.

sLevel

ulLevel

Directory Limits Information Data Structure

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_PATH_NOT_FOUND Г 3 Г The path was not found. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_ACCESS_DENIED Г 5 Г Administrator privilege is required. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_NOT_SUPPORTED Г 50 Г This request is not supported by the Г
Г Г Г network. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_INVALID_PARAMETER Г 87 Г At least one parameter value is not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_INVALID_NAME Г 123 Г There is an incorrect character or incor- Г
Г Г Г rectly formed file system name. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_INVALID_LEVEL Г 124 Г The sLevel parameter is not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_MORE_DATA Г234 ГAdditionaldataisavailable ,butthe Г
Г Г Г buffer is too small. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_NetNotStarted Г 2101 Г The device driver is not started. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_RedirectedPath Г 2117 Г The operation is not valid on a redirected Г
Г Г Г device. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_BufTooSmall Г 2123 Г The buffer is too small for fixed-length Г
Г Г Г data. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_ACFNotLoaded Г 2227 Г The UAS database has not been started. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_DASDNotInstalled Г 2301 Г Directory limits are not enabled on the Г
Г Г Г specified drive. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_NotHPFSVolume Г 2303 Г The directory is not on a 386-HPFS volume. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_DASDNotOperational Г 2309 Г The NET DASD operation failed. Support Г
Г Г Г for directory limits is enabled, but is Г
Г Г Г not yet operational. Г
Г Г Г Г
Г Г Г Cause: Directory limits operations on this Г
Г Г Г drive cannot be performed until support Г
Г Г Г for directory limits is operational. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_NetNameNotFound Г 2310 Г This shared resource does not exist. Г
РФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

Other codes could be returned by the DosAllocSeg function.

If you call this API with the buffer length parameter equal to zero, the API returns a value for total entries available. This technique is useful if you do not know the exact buffer size required.

[Back]

[Next]