NWAFPSetFileInformation

Sets AFP information for a file or directory

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:AFP

Syntax

  #include <nwafp.h> 
  or 
  #include <nwcalls.h> 
  
  NWCCODE NWAPI NWAFPSetFileInformation ( 
     NWCONN_HANDLE           conn,  
     nuint16                 volNum,  
     nuint32                 AFPBaseID,  
     nuint16                 reqMask,  
     const nstr8 N_FAR      *AFPPathString,  
     nuint16                 structSize,  
     NW_AFP_SET_INFO N_FAR  *AFPSetInfo);
  

Delphi Syntax

  uses calwin32 
   
  Function NWAFPSetFileInformation 
    (conn : NWCONN_HANDLE; 
     volNum : nuint16; 
     AFPBaseID : nuint32; 
     reqMask : nuint16; 
     const AFPPathString : pnstr8; 
     structSize : nuint16; 
     Var AFPSetInfo : NW_AFP_SET_INFO 
  ) : NWCCODE;
  

Parameters

conn
(IN) Specifies the NetWare server connection handle.
volNum
(IN) Specifies the volume number of the directory entry location.
AFPBaseID
(IN) Specifies the AFP base ID.
reqMask
(IN) Specifies the request bit mask information.
AFPPathString
(IN) Points to the AFP directory path relative to AFPBaseID.
structSize
(IN) Specifies the size of the AFPSETINFO buffer.
AFPSetInfo
(IN) Points to AFPSETINFO to set AFP file information.

Return Values

These are common return values; see Return Values (Return Values for C) for more information.

0x0000

SUCCESSFUL

0x8801

INVALID_CONNECTION

0x8901

ERR_INSUFFICIENT_SPACE

0x890A

NLM_INVALID_CONNECTION

0x8983

IO_ERROR_NETWORK_DISK

0x8988

INVALID_FILE_HANDLE

0x8993

NO_READ_PRIVILEGES

0x8994

NO_WRITE_PRIVILEGES_OR_READONLY

0x8995

FILE_DETACHED

0x8996

SERVER_OUT_OF_MEMORY

0x8998

VOLUME_DOES_NOT_EXIST

0x899C

INVALID_PATH

0x89A1

DIRECTORY_IO_ERROR

0x89A2

READ_FILE_WITH_RECORD_LOCKED

0x89FD

BAD_STATION_NUMBER

0x89FF

Failure; NO_FILES_FOUND_ERROR

Remarks

The following constants are used by NWAFPSetFileInformation to manipulate requestMask. They are also used in by NWSEARCH_MASK in NWAFPScanFileInformation.

C Values

Delphi Values

Value Names

0x0001

$0001

AFP_GET_ATTRIBUTES

0x0002

$0002

AFP_GET_PARENT_ID

0x0004

$0004

AFP_GET_CREATE_DATE

0x0008

$0008

AFP_GET_ACCESS_DATE

0x0010

$0010

AFP_GET_MODIFY_DATETIME

0x0020

$0020

AFP_GET_BACKUP_DATETIME

0x0040

$0040

AFP_GET_FINDER_INFO

0x0080

$0080

AFP_GET_LONG_NAME

0x0100

$0100

AFP_GET_ENTRY_ID

0x0200

$0200

AFP_GET_DATA_LEN

0x0400

$0400

AFP_GET_RESOURCE_LEN

0x0800

$0800

AFP_GET_NUM_OFFSPRING

0x1000

$1000

AFP_GET_OWNER_ID

0x2000

$2000

AFP_GET_SHORT_NAME

0x4000

$4000

AFP_GET_ACCESS_RIGHTS

0x8000

$8000

AFP_GET_PRO_DOS_INFO

0xffff

$ffff

AFP_GET_ALL

These constants identify AFP entries to be included in NWAFPSetFileInformation.

C Values

Delphi Values

Value Names

0x0000

$0000

AFP_SA_NORMAL

0x0100

$0100

AFP_SA_HIDDEN

0x0200

$0200

AFP_SA_SYSTEM

0x0400

$0400

AFP_SA_SUBDIR

0x0800

$0800

AFP_SA_FILES

0xF00

$0F00

AFP_SA_ALL

Valid bit map information request values follow for reqMask: (Bits can be ORed together.)

C Values

Delphi Values

Value Names

0x0001

$0001

AFP_SET_ATTRIBUTES

0x0004

$0004

AFP_SET_CREATE_DATE

0x0008

$0008

AFP_SET_ACCESS_DATE

0x0010

$0010

AFP_SET_MODIFY_DATETIME

0x0020

$0020

AFP_SET_BACKUP_DATETIME

0x0040

$0040

AFP_SET_FINDER_INFO

0x8000

$8000

AFP_SET_PRO_DOS_INFO

AFPSETINFO attributes follow:

  0x0001 = Search Mode 
  0x0002 = Search Mode 
  0x0004 = Search Mode 
  0x0008 = Undefined 
  0x0010 = Transaction 
  0x0020 = Index 
  0x0040 = Read Audit 
  0x0080 = Write Audit 
  0x0100 = Read Only 
  0x0200 = Hidden 
  0x0400 = System 
  0x0800 = Execute Only 
  0x1000 = Subdirectory 
  0x2000 = Archive 
  0x4000 = Undefined 
  0x8000 = Shareable File
  

NCP Calls

See Also

NWAFPGetFileInformation, NWAFPScanFileInformation, NWSetLongName (Multiple and Inter-File Services)