NetAccessApply or Net32AccessApply

After an access permission record is defined for a directory, the NetAccessApply API replicates that record, applying it to all subdirectories under that directory.

This API also updates the access permission for any file within the directory tree that already has an access permission record. It does not create a record for a file that does not already have one. (If it does not have its own access permission record, a file defaults to the record of its parent directory.) This API does not replace existing audit trail settings, but it does apply the audit settings of the specified directory to any of its subdirectories that have no audit settings.

Restrictions

This API does not apply an access permission record to any of the following LAN Server system subdirectories:

IBMLAN
IBMLAN\DCDB and its subdirectories
IBMLAN\NETPROG and its subdirectories
IBMLAN\DOSLAN and its subdirectories

LAN Server and OS/2 Warp Server Only

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. Administrator authority is required to call this API.

Directory and Security Server Only

NetAccessApply must be run from a DSS server or client. If it is run from a LAN Server or OS/2 Warp Server server, this API returns NERR_InvalidAPI.

#include <netcons.h>#include <access.h>
 
NetAccessApply(pszServername, pszDirPath, buf, usBuflen,
               reserved1, reserved2, options);     /* 16 bit */
 
Net32AccessApply(pszServername, pszDirPath, buf, ulBuflen,
               reserved1, reserved2, options);     /* 32 bit */

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

buf

Apply Access Control Data Structure

reserved1

(unsigned char LSFAR *) must be NULL.

reserved2

(unsigned long) must be 0.

options

(unsigned long) must be APPLY_ABSOLUTE (value of 0x01), which replaces any existing access control profile for all subdirectories under the specified directory.

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_ACCESS_DENIED Г 5 Г Administrator privilege is required. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_INVALID_PARAMETER Г 87 Г At least one parameter value is not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_BAD_PATHNAME Г 161 Г Path name not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г ERROR_MORE_DATA Г 234 Г Additional data is available, but the Г
Г Г Г buffer is too small. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_NetNotStarted Г 2102 Г The redirector NETWKSTA.200 has not been Г
Г Г Г started. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_UnknownDevDir Г 2116 Г The device or directory does not exist. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_BufTooSmall Г 2123 Г The buffer is too small for fixed-length Г
Г Г Г data. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_InternalError Г 2140 Г An internal error has occurred. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_BadTransactConfig Г 2141 Г The server is not configured for trans- Г
Г Г Г actions. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_InvalidAPI Г 2142 Г The requested API is not supported on the Г
Г Г Г remote server. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_InvalidComputer Г 2351 Г The specified computer name is not valid. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_ApplyNotPermitted Г2800 ГTheapplyoperationisnotallowedonthe Г
Г Г Г specified path. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_IncompleteApply Г 2801 Г The apply operation ended prematurely. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_DCEErrorLogged Г 7501 Г DCE error status has been logged. Г
УФФФФФФФФФФФФФФФФФФФФФФФФФХФФФФФФФХФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФД
Г NERR_AppyUnexpectedErrorГ 7799 Г The apply server encountered an unexpected Г
Г Г Г error. Г
РФФФФФФФФФФФФФФФФФФФФФФФФФСФФФФФФФСФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФФй

Other codes could be returned from the following functions:

DosExecPgm
DosAllocShrSeg
DosFsCtl

[Back]

[Next]