Scan Bindery Object Trustee Paths 0x2222 23 71

Returns a path on the specified volume where the given object ID is a trustee.

NetWare Server:2.x, 3.x, 4.x, 5.x

Request Format

Offset

Content

Type

Request header

6

FunctionCode (23)

byte

7

SubFuncStrucLen (8)

word (Hi-Lo)

9

SubFunctionCode (71)

byte

10

VolumeNumber

byte

11

LastSequenceNumber

word (Hi-Lo)

13

ObjectID

long (Hi-Lo)

Reply Format

Offset

Content

Type

Reply header

8

NextSequenceNumber

word (Hi-Lo)

10

ObjectID

long (Hi-Lo)

14

TrusteeAccessMask

byte

15

DirectoryPathLen

byte

16

DirectoryPath

byte[DirectoryPathLen]

Return Values

Decimal

Hex

Description

0

0x00

Successful

147

0x93

No Read Privileges

150

0x96

Server Out of Memory

161

0xA1

Directory I/O Error

240

0xF0

Illegal Wildcard

241

0xF1

Bindery Security

242

0xF2

No Object Read

252

0xFC

No Such Object

254

0xFE

Directory Locked

255

0xFF

Hard Failure

Remarks

The path that is returned is also known as the trustee path. Scan Bindery Object Trustee Paths can be called iteratively to determine all the paths on a specified volume where ObjectID appears in a directory's trustee list.

You should set VolumeNumber to the desired volume number. To map a volume name to its mount number, or to determine which volumes are mounted on a server, call Get Volume Number (0x2222 22 5) and Get Volume Name (0x2222 22 6).

Set SequenceNumber initially to -1L (long -1). For subsequent requests, SequenceNumber should be set to the value returned in NextSequenceNumber of the previous request.

ObjectID must contain the number of the object (user) whose trustee directory paths you are requesting.

The file server returns DirectoryPath in the following format:

  volume:directory/subdirectory/subdirectory/. . .
  

Directory paths are not returned in any special order. The server will return a DirectoryPathLen of zero if all directory paths where the object is listed as a trustee have been returned.

A client who is supervisor (or equivalent) can call Scan Bindery Object Trustee Paths to investigate the trustee directory rights of any object in the bindery.

Any client can call Scan Bindery Object Trustee Paths to determine its own trustee paths, or the trustee paths of any object (up to 32) to which the client is security equivalent.

See Also

Scan Bindery Object 0x2222 23 55