271 lines
5 KiB
C
271 lines
5 KiB
C
/*++ BUILD Version: 0001 // Increment this if a change has global effects
|
|
|
|
Copyright (c) 1991-1995 Microsoft Corporation
|
|
|
|
Module Name:
|
|
|
|
lmchdev.h
|
|
|
|
Abstract:
|
|
|
|
This module defines the API function prototypes and data structures
|
|
for the following groups of NT API functions:
|
|
NetCharDev
|
|
NetCharDevQ
|
|
NetHandle
|
|
|
|
[Environment:]
|
|
|
|
User Mode - Win32
|
|
|
|
[Notes:]
|
|
|
|
You must include NETCONS.H before this file, since this file depends
|
|
on values defined in NETCONS.H.
|
|
|
|
--*/
|
|
|
|
#ifndef _LMCHDEV_
|
|
#define _LMCHDEV_
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
//
|
|
// CharDev Class
|
|
//
|
|
|
|
//
|
|
// Function Prototypes - CharDev
|
|
//
|
|
|
|
NET_API_STATUS NET_API_FUNCTION
|
|
NetCharDevEnum (
|
|
IN LPTSTR servername,
|
|
IN DWORD level,
|
|
OUT LPBYTE *bufptr,
|
|
IN DWORD prefmaxlen,
|
|
OUT LPDWORD entriesread,
|
|
OUT LPDWORD totalentries,
|
|
IN OUT LPDWORD resume_handle
|
|
);
|
|
|
|
NET_API_STATUS NET_API_FUNCTION
|
|
NetCharDevGetInfo (
|
|
IN LPTSTR servername,
|
|
IN LPTSTR devname,
|
|
IN DWORD level,
|
|
OUT LPBYTE *bufptr
|
|
);
|
|
|
|
NET_API_STATUS NET_API_FUNCTION
|
|
NetCharDevControl (
|
|
IN LPTSTR servername,
|
|
IN LPTSTR devname,
|
|
IN DWORD opcode
|
|
);
|
|
|
|
//
|
|
// Data Structures - CharDev
|
|
//
|
|
|
|
typedef struct _CHARDEV_INFO_0 {
|
|
LPTSTR ch0_dev;
|
|
} CHARDEV_INFO_0, *PCHARDEV_INFO_0, *LPCHARDEV_INFO_0;
|
|
|
|
typedef struct _CHARDEV_INFO_1 {
|
|
LPTSTR ch1_dev;
|
|
DWORD ch1_status;
|
|
LPTSTR ch1_username;
|
|
DWORD ch1_time;
|
|
} CHARDEV_INFO_1, *PCHARDEV_INFO_1, *LPCHARDEV_INFO_1;
|
|
|
|
|
|
//
|
|
// CharDevQ Class
|
|
//
|
|
|
|
//
|
|
// Function Prototypes - CharDevQ
|
|
//
|
|
|
|
NET_API_STATUS NET_API_FUNCTION
|
|
NetCharDevQEnum (
|
|
IN LPTSTR servername,
|
|
IN LPTSTR username,
|
|
IN DWORD level,
|
|
OUT LPBYTE *bufptr,
|
|
IN DWORD prefmaxlen,
|
|
OUT LPDWORD entriesread,
|
|
OUT LPDWORD totalentries,
|
|
IN OUT LPDWORD resume_handle
|
|
);
|
|
|
|
NET_API_STATUS NET_API_FUNCTION
|
|
NetCharDevQGetInfo (
|
|
IN LPTSTR servername,
|
|
IN LPTSTR queuename,
|
|
IN LPTSTR username,
|
|
IN DWORD level,
|
|
OUT LPBYTE *bufptr
|
|
);
|
|
|
|
NET_API_STATUS NET_API_FUNCTION
|
|
NetCharDevQSetInfo (
|
|
IN LPTSTR servername,
|
|
IN LPTSTR queuename,
|
|
IN DWORD level,
|
|
IN LPBYTE buf,
|
|
OUT LPDWORD parm_err
|
|
);
|
|
|
|
NET_API_STATUS NET_API_FUNCTION
|
|
NetCharDevQPurge (
|
|
IN LPTSTR servername,
|
|
IN LPTSTR queuename
|
|
);
|
|
|
|
NET_API_STATUS NET_API_FUNCTION
|
|
NetCharDevQPurgeSelf (
|
|
IN LPTSTR servername,
|
|
IN LPTSTR queuename,
|
|
IN LPTSTR computername
|
|
);
|
|
|
|
//
|
|
// Data Structures - CharDevQ
|
|
//
|
|
|
|
typedef struct _CHARDEVQ_INFO_0 {
|
|
LPTSTR cq0_dev;
|
|
} CHARDEVQ_INFO_0, *PCHARDEVQ_INFO_0, *LPCHARDEVQ_INFO_0;
|
|
|
|
typedef struct _CHARDEVQ_INFO_1 {
|
|
LPTSTR cq1_dev;
|
|
DWORD cq1_priority;
|
|
LPTSTR cq1_devs;
|
|
DWORD cq1_numusers;
|
|
DWORD cq1_numahead;
|
|
} CHARDEVQ_INFO_1, *PCHARDEVQ_INFO_1, *LPCHARDEVQ_INFO_1;
|
|
|
|
typedef struct _CHARDEVQ_INFO_1002 {
|
|
DWORD cq1002_priority;
|
|
} CHARDEVQ_INFO_1002, *PCHARDEVQ_INFO_1002, *LPCHARDEVQ_INFO_1002;
|
|
|
|
typedef struct _CHARDEVQ_INFO_1003 {
|
|
LPTSTR cq1003_devs;
|
|
} CHARDEVQ_INFO_1003, *PCHARDEVQ_INFO_1003, *LPCHARDEVQ_INFO_1003;
|
|
|
|
|
|
//
|
|
// Special Values and Constants
|
|
//
|
|
|
|
//
|
|
// Bits for chardev_info_1 field ch1_status.
|
|
//
|
|
|
|
#define CHARDEV_STAT_OPENED 0x02
|
|
#define CHARDEV_STAT_ERROR 0x04
|
|
|
|
//
|
|
// Opcodes for NetCharDevControl
|
|
//
|
|
|
|
#define CHARDEV_CLOSE 0
|
|
|
|
//
|
|
// Values for parm_err parameter.
|
|
//
|
|
|
|
#define CHARDEVQ_DEV_PARMNUM 1
|
|
#define CHARDEVQ_PRIORITY_PARMNUM 2
|
|
#define CHARDEVQ_DEVS_PARMNUM 3
|
|
#define CHARDEVQ_NUMUSERS_PARMNUM 4
|
|
#define CHARDEVQ_NUMAHEAD_PARMNUM 5
|
|
|
|
//
|
|
// Single-field infolevels for NetCharDevQSetInfo.
|
|
//
|
|
|
|
#define CHARDEVQ_PRIORITY_INFOLEVEL \
|
|
(PARMNUM_BASE_INFOLEVEL + CHARDEVQ_PRIORITY_PARMNUM)
|
|
#define CHARDEVQ_DEVS_INFOLEVEL \
|
|
(PARMNUM_BASE_INFOLEVEL + CHARDEVQ_DEVS_PARMNUM)
|
|
|
|
//
|
|
// Minimum, maximum, and recommended default for priority.
|
|
//
|
|
|
|
#define CHARDEVQ_MAX_PRIORITY 1
|
|
#define CHARDEVQ_MIN_PRIORITY 9
|
|
#define CHARDEVQ_DEF_PRIORITY 5
|
|
|
|
//
|
|
// Value indicating no requests in the queue.
|
|
//
|
|
|
|
#define CHARDEVQ_NO_REQUESTS -1
|
|
|
|
#endif // _LMCHDEV_
|
|
|
|
//
|
|
// Handle Class
|
|
//
|
|
|
|
#ifndef _LMHANDLE_
|
|
#define _LMHANDLE_
|
|
|
|
//
|
|
// Function Prototypes
|
|
//
|
|
|
|
NET_API_STATUS NET_API_FUNCTION
|
|
NetHandleGetInfo (
|
|
IN HANDLE handle,
|
|
IN DWORD level,
|
|
OUT LPBYTE *bufptr
|
|
);
|
|
|
|
NET_API_STATUS NET_API_FUNCTION
|
|
NetHandleSetInfo (
|
|
IN HANDLE handle,
|
|
IN DWORD level,
|
|
IN LPBYTE buf,
|
|
IN DWORD parmnum,
|
|
OUT LPDWORD parmerr
|
|
);
|
|
|
|
//
|
|
// Data Structures
|
|
//
|
|
|
|
typedef struct _HANDLE_INFO_1 {
|
|
DWORD hdli1_chartime;
|
|
DWORD hdli1_charcount;
|
|
}HANDLE_INFO_1, *PHANDLE_INFO_1, *LPHANDLE_INFO_1;
|
|
|
|
//
|
|
// Special Values and Constants
|
|
//
|
|
|
|
//
|
|
// Handle Get Info Levels
|
|
//
|
|
|
|
#define HANDLE_INFO_LEVEL_1 1
|
|
|
|
//
|
|
// Handle Set Info parm numbers
|
|
//
|
|
|
|
#define HANDLE_CHARTIME_PARMNUM 1
|
|
#define HANDLE_CHARCOUNT_PARMNUM 2
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#endif // _LMHANDLE_
|