/***********************************************************************
 *
 *  Copyright (C) 2005-2006 Novell, Inc. All Rights Reserved.
 *
 *  This library is free software; you can redistribute it and/or
 *  modify it under the terms of the GNU Lesser General Public
 *  License as published by the Free Software Foundation; version 2.1
 *  of the License.
 *
 *  This library is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 *  Library Lesser General Public License for more details.
 *
 *  You should have received a copy of the GNU Lesser General Public
 *  License along with this library; if not, Novell, Inc.
 *
 *  To contact Novell about this file by physical or electronic mail,
 *  you may find current contact information at www.novell.com.
 *
 ***********************************************************************/

#if ! defined ( NWDPATH_H )
#define NWDPATH_H

#if ! defined ( NTYPES_H )
#include "ntypes.h"
#endif

#if ! defined ( NWCALDEF_H )
#include "nwcaldef.h"
#endif

#include "npackon.h"

#ifdef __cplusplus
extern "C" {
#endif

/* status values for NWGetDriveStatus */
#define NW_UNMAPPED_DRIVE     0x0000
#define NW_FREE_DRIVE         0x0000
#define NW_CDROM_DRIVE        0x0400
#define NW_LOCAL_FREE_DRIVE   0x0800
#define NW_LOCAL_DRIVE        0x1000
#define NW_NETWORK_DRIVE      0x2000
#define NW_LITE_DRIVE         0x4000
#define NW_PNW_DRIVE          0x4000
#define NW_NETWARE_DRIVE      0x8000

/* return error for NWGetDriveStatus */
#define NW_INVALID_DRIVE       15

/* defined for pathFormat parameter in NWGetDriveStatus */
#define NW_FORMAT_NETWARE       0
#define NW_FORMAT_SERVER_VOLUME 1
#define NW_FORMAT_DRIVE         2
#define NW_FORMAT_UNC           3

N_EXTERN_LIBRARY( NWCCODE )
NWSetDriveBase
(
   nuint16             driveNum,
   NWCONN_HANDLE       conn,
   NWDIR_HANDLE        dirHandle,
   const nstr8 N_FAR * dirPath,
   nuint16             driveScope
);

N_EXTERN_LIBRARY( NWCCODE )
NWSetInitDrive
(
   NWCONN_HANDLE  conn
);

N_EXTERN_LIBRARY( NWCCODE )
NWSetSearchDriveVector
(
   pnstr8   vectorBuffer
);

N_EXTERN_LIBRARY( NWCCODE )
NWGetSearchDriveVector
(
   pnstr8   vectorBuffer
);

N_EXTERN_LIBRARY( NWCCODE )
NWDeleteDriveBase
(
   nuint16  driveNum,
   nuint16  driveScope
);

N_EXTERN_LIBRARY( NWCCODE )
NWGetPathFromDirectoryBase  /* 3.x & 4.x file servers */
(
   NWCONN_HANDLE  conn,
   nuint8         volNum,
   nuint32        dirBase,
   nuint8         namSpc,
   pnuint8        len,
   pnstr8         pathName
);

N_EXTERN_LIBRARY( NWCCODE )
NWGetPathFromDirectoryEntry  /* 2.x file servers only */
(
   NWCONN_HANDLE  conn,
   nuint8         volNum,
   nuint16        dirEntry,
   pnuint8        len,
   pnstr8         pathName
);

N_EXTERN_LIBRARY( NWCCODE )
NWGetDrivePathConnRef
(
   nuint16        driveNum,
   nuint16        mode,
   pnuint32       connRef,
   pnstr8         basePath,
   pnuint16       driveScope
);

N_EXTERN_LIBRARY( NWCCODE )
NWGetDrivePath
(
   nuint16        driveNum,
   nuint16        mode,
   NWCONN_HANDLE N_FAR * conn,
   pnstr8         basePath,
   pnuint16       driveScope
);

N_EXTERN_LIBRARY( NWCCODE )
NWGetDriveInformation
(
   nuint16        driveNum,
   nuint16        mode,
   NWCONN_HANDLE N_FAR * conn,
   NWDIR_HANDLE N_FAR * dirHandle,
   pnuint16       driveScope,
   pnstr8         dirPath
);

N_EXTERN_LIBRARY( NWCCODE )
NWGetDriveInfoConnRef
(
   nuint16        driveNum,
   nuint16        mode,
   pnuint32       connRef,
   NWDIR_HANDLE N_FAR * dirHandle,
   pnuint16       driveScope,
   pnstr8         dirPath
);

N_EXTERN_LIBRARY( NWCCODE )
NWGetDriveStatus
(
   nuint16        driveNum,
   nuint16        pathFormat,
   pnuint16       status,
   NWCONN_HANDLE N_FAR * conn,
   pnstr8         rootPath,
   pnstr8         relPath,
   pnstr8         fullPath
);

N_EXTERN_LIBRARY( NWCCODE )
NWGetDriveStatusConnRef
(
   nuint16        driveNum,
   nuint16        pathFormat,
   pnuint16       status,
   pnuint32       connRef,
   pnstr8         rootPath,
   pnstr8         relPath,
   pnstr8         fullPath
);

N_EXTERN_LIBRARY( NWCCODE )
NWGetFirstDrive
(
   pnuint16       firstDrive
);

N_EXTERN_LIBRARY( NWCCODE )
NWParseNetWarePath
(
   const nstr8   N_FAR * path,
   NWCONN_HANDLE N_FAR * conn,
   NWDIR_HANDLE  N_FAR * dirHandle,
   pnstr8                newPath
);

N_EXTERN_LIBRARY( NWCCODE )
NWParseNetWarePathConnRef
(
   const nstr8  N_FAR * path,
   pnuint32             connRef,
   NWDIR_HANDLE N_FAR * dirHandle,
   pnstr8               newPath
);

N_EXTERN_LIBRARY( NWCCODE )
NWParsePathConnRef
(
   const nstr8 N_FAR * path,
   pnstr8              serverName,
   pnuint32            connRef,
   pnstr8              volName,
   pnstr8              dirPath
);

N_EXTERN_LIBRARY( NWCCODE )
NWParsePath
(
   const nstr8   N_FAR * path,
   pnstr8                serverName,
   NWCONN_HANDLE N_FAR * conn,
   pnstr8                volName,
   pnstr8                dirPath
);

N_EXTERN_LIBRARY( pnstr8 )
NWStripServerOffPath
(
   const nstr8 N_FAR * path,
   pnstr8              server
);

N_EXTERN_LIBRARY( NWCCODE )
NWCreateUNCPath
(
   NWCONN_HANDLE  conn,
   NWDIR_HANDLE   dirHandle,
   pnstr8         path,
   pnstr8         UNCPath
);

#ifdef __cplusplus
}
#endif

#include "npackoff.h"
#endif