NetDASDSetInfo or Net32DASDSetInfo

The NetDASDSetInfo API sets directory limit restrictions on a specific directory resource. 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. Or the caller may have P permission to the parent directory.

The d0_use field in the data structure is ignored for this API.

Syntax

#include <neterr.h>
#include <dasd.h>
 
NetDASDSetInfo(pszServername, pszDirPath, sLevel,
                buf, usBuflen);    /* 32 bit */
 
Net32DASDSetInfo(pszServername, pszDirPath, ulLevel,
                buf, ulBuflen);    /* 32 bit */

Parameters

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

pszDirPath

(unsigned char LSFAR *) points to an ASCIIZ string containing the name of the directory that is to be set with this call. (The ASCIIZ string itself is in the form of a complete directory path, beginning with the drive letter. This string must be identical to that specified in the d0_resource_namefield in the data structure.)

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

sLevel or ulLevel
(16-bit short or 32-bit unsigned long) must be 0, which specifies the data structure described in Directory Limits 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_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. │
├─────────────────────────┼───────┼────────────────────────────────────────────┤
│ 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_UserNotFound │ 2221 │ The user name cannot be found. │
├─────────────────────────┼───────┼────────────────────────────────────────────┤
│ 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_DASDMaxValidationFa │ l2304 │Thesupplieddirectorylimitissmaller │
│ │ │ than the current directory size. The limit │
│ │ │ was not applied. │
├─────────────────────────┼───────┼────────────────────────────────────────────┤
│ NERR_LimitNotFound │ 2306 │ The directory limit was not found. │
├─────────────────────────┼───────┼────────────────────────────────────────────┤
│ 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.

---

[Back: NetDASDGetInfo or Net32DASDGetInfo]
[Next: Mailslot Category]