Platform SDK: Network Management

access_info_1

Windows 95/98: The access_info_1 structure contains the name of a resource, auditing attributes for the resource, and the number of resource permission structures that follow the structure.

Windows NT/2000: This structure is not supported on Windows NT/Windows 2000.

struct _access_info_1 {
  char FAR *      acc1_resource_name;
  short           acc1_attr;
  short           acc1_count;
};

Members

acc1_resource_name
Pointer to a string specifying the name of the resource. The following resource types are valid.
Resource type Required format
Disk drive drive:
Path \path
Directory drive:\pathname
File drive:\pathname
UNC \\server\sharename\path
Pipe \pipe\pipename
Printer queue \print\queuename

acc1_attr
Specifies a SHORT variable that indicates whether auditing of access events is required for the resource identified by the acc1_resource_name member.

If this member is equal to 1 or to the value ACCESS_AUDIT, it indicates that all access events should be audited. If this member is equal to 0, no auditing is required. Other values indicate auditing of specific access events, as listed in the following table.
Bit File event Directory event
0 Audit all access events. When you set this bit, all access attempts are audited. Any other bits you set are ignored. Same as the file event.
1-2 Reserved; must be zero. Reserved; must be zero.
3 Ignored. Reserved.
4 Successful opens. Reserved.
5 Successful writes. Successful creates.
6 Successful deletes and truncates. Successful deletes.
7 Successful ACL changes. Same as the file event.
8 Failed opens. Reserved.
9 Failed writes. Failed creates.
10 Failed deletes and truncates. Failed deletes.
11 Failed ACL changes. Same as the file event.
12-15 Reserved; must be zero. Reserved; must be zero.

Other resources that you can access over the network, including printer queues, communication-device queues, and pipes, are audited in the same manner as files.

When auditing of write events is enabled, auditing logs the event the first time the file is opened with write permission. File size changes (including truncation) are audited by bits 5 and 9.

acc1_count
Specifies a SHORT variable that indicates the number of access_list structures that follow the access_info_1 structure.

Requirements

  Windows NT/2000: Unsupported.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Svrapi.h.

See Also

Network Management Overview, Network Management Structures, Access Functions, access_list, NetAccessEnum, NetAccessGetInfo, NetAccessSetInfo