windows-nt/Source/XPSP1/NT/public/sdk/inc/lmsvc.h

539 lines
13 KiB
C
Raw Permalink Normal View History

2020-09-26 03:20:57 -05:00
/*++ BUILD Version: 0002 // Increment this if a change has global effects
Copyright (c) 1991-1999 Microsoft Corporation
Module Name:
lmsvc.h
Abstract:
This file contains structures, function prototypes, and definitions
for the NetService API.
[Environment:]
User Mode -Win32
[Notes:]
You must include NETCONS.H before this file, since this file depends
on values defined in NETCONS.H.
--*/
#ifndef _LMSVC_
#define _LMSVC_
#if _MSC_VER > 1000
#pragma once
#endif
#ifdef __cplusplus
extern "C" {
#endif
//
// Include the file which contains all the service name strings.
//
#include <lmsname.h>
//
// Data Structures
//
typedef struct _SERVICE_INFO_0 {
LPWSTR svci0_name;
} SERVICE_INFO_0, *PSERVICE_INFO_0, * LPSERVICE_INFO_0;
typedef struct _SERVICE_INFO_1 {
LPWSTR svci1_name;
DWORD svci1_status;
DWORD svci1_code;
DWORD svci1_pid;
} SERVICE_INFO_1, *PSERVICE_INFO_1, * LPSERVICE_INFO_1;
typedef struct _SERVICE_INFO_2 {
LPWSTR svci2_name;
DWORD svci2_status;
DWORD svci2_code;
DWORD svci2_pid;
LPWSTR svci2_text;
DWORD svci2_specific_error;
LPWSTR svci2_display_name;
} SERVICE_INFO_2, *PSERVICE_INFO_2, * LPSERVICE_INFO_2;
//
// Function Prototypes
//
NET_API_STATUS NET_API_FUNCTION
NetServiceControl (
IN LPCWSTR servername OPTIONAL,
IN LPCWSTR service,
IN DWORD opcode,
IN DWORD arg,
OUT LPBYTE *bufptr
);
NET_API_STATUS NET_API_FUNCTION
NetServiceEnum (
IN LPCWSTR servername OPTIONAL,
IN DWORD level,
OUT LPBYTE *bufptr,
IN DWORD prefmaxlen,
OUT LPDWORD entriesread,
OUT LPDWORD totalentries,
IN OUT LPDWORD resume_handle OPTIONAL
);
NET_API_STATUS NET_API_FUNCTION
NetServiceGetInfo (
IN LPCWSTR servername OPTIONAL,
IN LPCWSTR service,
IN DWORD level,
OUT LPBYTE *bufptr
);
NET_API_STATUS NET_API_FUNCTION
NetServiceInstall (
IN LPCWSTR servername OPTIONAL,
IN LPCWSTR service,
IN DWORD argc,
IN LPCWSTR argv[],
OUT LPBYTE *bufptr
);
//
// Special Values and Constants
//
//
// Bitmask and bit values for svci1_status, and svci2_status
// fields. For each "subfield", there is a mask defined,
// and a number of constants representing the value
// obtained by doing (status & mask).
//
// Bits 0,1 -- general status
#define SERVICE_INSTALL_STATE 0x03
#define SERVICE_UNINSTALLED 0x00
#define SERVICE_INSTALL_PENDING 0x01
#define SERVICE_UNINSTALL_PENDING 0x02
#define SERVICE_INSTALLED 0x03
// Bits 2,3 -- paused/active status
#define SERVICE_PAUSE_STATE 0x0C
#define LM20_SERVICE_ACTIVE 0x00
#define LM20_SERVICE_CONTINUE_PENDING 0x04
#define LM20_SERVICE_PAUSE_PENDING 0x08
#define LM20_SERVICE_PAUSED 0x0C
// Bit 4 -- uninstallable indication
#define SERVICE_NOT_UNINSTALLABLE 0x00
#define SERVICE_UNINSTALLABLE 0x10
// Bit 5 -- pausable indication
#define SERVICE_NOT_PAUSABLE 0x00
#define SERVICE_PAUSABLE 0x20
// Workstation service only:
// Bits 8,9,10 -- redirection paused/active
#define SERVICE_REDIR_PAUSED 0x700
#define SERVICE_REDIR_DISK_PAUSED 0x100
#define SERVICE_REDIR_PRINT_PAUSED 0x200
#define SERVICE_REDIR_COMM_PAUSED 0x400
//
// Additional standard LAN Manager for MS-DOS services
//
#define SERVICE_DOS_ENCRYPTION L"ENCRYPT"
//
// NetServiceControl opcodes.
//
#define SERVICE_CTRL_INTERROGATE 0
#define SERVICE_CTRL_PAUSE 1
#define SERVICE_CTRL_CONTINUE 2
#define SERVICE_CTRL_UNINSTALL 3
//
// Workstation service only: Bits used in the "arg" parameter
// to NetServiceControl in conjunction with the opcode
// SERVICE_CTRL_PAUSE or SERVICE_CTRL_CONTINUE, to pause or
// continue redirection.
//
#define SERVICE_CTRL_REDIR_DISK 0x1
#define SERVICE_CTRL_REDIR_PRINT 0x2
#define SERVICE_CTRL_REDIR_COMM 0x4
//
// Values for svci1_code, and svci2_code when status
// of the service is SERVICE_INSTALL_PENDING or
// SERVICE_UNINSTALL_PENDING.
// A service can optionally provide a hint to the installer
// that the install is proceeding and how long to wait
// (in 0.1 second increments) before querying status again.
//
#define SERVICE_IP_NO_HINT 0x0
#define SERVICE_CCP_NO_HINT 0x0
#define SERVICE_IP_QUERY_HINT 0x10000
#define SERVICE_CCP_QUERY_HINT 0x10000
//
// Mask for install proceeding checkpoint number
//
#define SERVICE_IP_CHKPT_NUM 0x0FF
#define SERVICE_CCP_CHKPT_NUM 0x0FF
//
// Mask for wait time hint before querying again
//
#define SERVICE_IP_WAIT_TIME 0x0FF00
#define SERVICE_CCP_WAIT_TIME 0x0FF00
//
// Shift count for building wait time _code values
//
#define SERVICE_IP_WAITTIME_SHIFT 8
#define SERVICE_NTIP_WAITTIME_SHIFT 12
//
// Mask used for upper and lower portions of wait hint time.
//
#define UPPER_HINT_MASK 0x0000FF00
#define LOWER_HINT_MASK 0x000000FF
#define UPPER_GET_HINT_MASK 0x0FF00000
#define LOWER_GET_HINT_MASK 0x0000FF00
#define SERVICE_NT_MAXTIME 0x0000FFFF
#define SERVICE_RESRV_MASK 0x0001FFFF
#define SERVICE_MAXTIME 0x000000FF
//
// SERVICE_BASE is the base of service error codes,
// chosen to avoid conflict with OS, redirector,
// netapi, and errlog codes.
//
// Don't change the comments following the manifest constants without
// understanding how mapmsg works.
//
#define SERVICE_BASE 3050
#define SERVICE_UIC_NORMAL 0
/*
* Uninstall codes, to be used in high byte of 'code' on final NetStatus,
* which sets the status to UNINSTALLED.
*/
#define SERVICE_UIC_BADPARMVAL (SERVICE_BASE + 1)
/*
* The Registry or the information you just typed includes an illegal
* value for "%1".
*/
#define SERVICE_UIC_MISSPARM (SERVICE_BASE + 2)
/*
* The required parameter was not provided on the command
* line or in the configuration file.
*/
#define SERVICE_UIC_UNKPARM (SERVICE_BASE + 3)
/*
* LAN Manager does not recognize "%1" as a valid option.
*/
#define SERVICE_UIC_RESOURCE (SERVICE_BASE + 4)
/*
* A request for resource could not be satisfied.
*/
#define SERVICE_UIC_CONFIG (SERVICE_BASE + 5)
/*
* A problem exists with the system configuration.
*/
#define SERVICE_UIC_SYSTEM (SERVICE_BASE + 6)
/*
* A system error has occurred.
*/
#define SERVICE_UIC_INTERNAL (SERVICE_BASE + 7)
/*
* An internal consistency error has occurred.
*/
#define SERVICE_UIC_AMBIGPARM (SERVICE_BASE + 8)
/*
* The configuration file or the command line has an ambiguous option.
*/
#define SERVICE_UIC_DUPPARM (SERVICE_BASE + 9)
/*
* The configuration file or the command line has a duplicate parameter.
*/
#define SERVICE_UIC_KILL (SERVICE_BASE + 10)
/*
* The service did not respond to control and was stopped with
* the DosKillProc function.
*/
#define SERVICE_UIC_EXEC (SERVICE_BASE + 11)
/*
* An error occurred when attempting to run the service program.
*/
#define SERVICE_UIC_SUBSERV (SERVICE_BASE + 12)
/*
* The sub-service failed to start.
*/
#define SERVICE_UIC_CONFLPARM (SERVICE_BASE + 13)
/*
* There is a conflict in the value or use of these options: %1.
*/
#define SERVICE_UIC_FILE (SERVICE_BASE + 14)
/*
* There is a problem with the file.
*/
//
// The modifiers
//
//
// General:
//
#define SERVICE_UIC_M_NULL 0
//
// RESOURCE:
//
#define SERVICE_UIC_M_MEMORY (SERVICE_BASE + 20) /* memory */
#define SERVICE_UIC_M_DISK (SERVICE_BASE + 21) /* disk space */
#define SERVICE_UIC_M_THREADS (SERVICE_BASE + 22) /* thread */
#define SERVICE_UIC_M_PROCESSES (SERVICE_BASE + 23) /* process */
//
// CONFIG:
//
//
// Security failure
//
#define SERVICE_UIC_M_SECURITY (SERVICE_BASE + 24)
/* Security Failure. %0 */
#define SERVICE_UIC_M_LANROOT (SERVICE_BASE + 25)
/*
* Bad or missing LAN Manager root directory.
*/
#define SERVICE_UIC_M_REDIR (SERVICE_BASE + 26)
/*
* The network software is not installed.
*/
#define SERVICE_UIC_M_SERVER (SERVICE_BASE + 27)
/*
* The server is not started.
*/
#define SERVICE_UIC_M_SEC_FILE_ERR (SERVICE_BASE + 28)
/*
* The server cannot access the user accounts database (NET.ACC).
*/
#define SERVICE_UIC_M_FILES (SERVICE_BASE + 29)
/*
* Incompatible files are installed in the LANMAN tree.
*/
#define SERVICE_UIC_M_LOGS (SERVICE_BASE + 30)
/*
* The LANMAN\LOGS directory is invalid.
*/
#define SERVICE_UIC_M_LANGROUP (SERVICE_BASE + 31)
/*
* The domain specified could not be used.
*/
#define SERVICE_UIC_M_MSGNAME (SERVICE_BASE + 32)
/*
* The computer name is being used as a message alias on another computer.
*/
#define SERVICE_UIC_M_ANNOUNCE (SERVICE_BASE + 33)
/*
* The announcement of the server name failed.
*/
#define SERVICE_UIC_M_UAS (SERVICE_BASE + 34)
/*
* The user accounts database is not configured correctly.
*/
#define SERVICE_UIC_M_SERVER_SEC_ERR (SERVICE_BASE + 35)
/*
* The server is not running with user-level security.
*/
#define SERVICE_UIC_M_WKSTA (SERVICE_BASE + 37)
/*
* The workstation is not configured properly.
*/
#define SERVICE_UIC_M_ERRLOG (SERVICE_BASE + 38)
/*
* View your error log for details.
*/
#define SERVICE_UIC_M_FILE_UW (SERVICE_BASE + 39)
/*
* Unable to write to this file.
*/
#define SERVICE_UIC_M_ADDPAK (SERVICE_BASE + 40)
/*
* ADDPAK file is corrupted. Delete LANMAN\NETPROG\ADDPAK.SER
* and reapply all ADDPAKs.
*/
#define SERVICE_UIC_M_LAZY (SERVICE_BASE + 41)
/*
* The LM386 server cannot be started because CACHE.EXE is not running.
*/
#define SERVICE_UIC_M_UAS_MACHINE_ACCT (SERVICE_BASE + 42)
/*
* There is no account for this computer in the security database.
*/
#define SERVICE_UIC_M_UAS_SERVERS_NMEMB (SERVICE_BASE + 43)
/*
* This computer is not a member of the group SERVERS.
*/
#define SERVICE_UIC_M_UAS_SERVERS_NOGRP (SERVICE_BASE + 44)
/*
* The group SERVERS is not present in the local security database.
*/
#define SERVICE_UIC_M_UAS_INVALID_ROLE (SERVICE_BASE + 45)
/*
* This computer is configured as a member of a workgroup, not as
* a member of a domain. The Netlogon service does not need to run in this
* configuration.
*/
#define SERVICE_UIC_M_NETLOGON_NO_DC (SERVICE_BASE + 46)
/*
* The primary Domain Controller for this domain could not be located.
*/
#define SERVICE_UIC_M_NETLOGON_DC_CFLCT (SERVICE_BASE + 47)
/*
* This computer is configured to be the primary domain controller of its domain.
* However, the computer %1 is currently claiming to be the primary domain controller
* of the domain.
*/
#define SERVICE_UIC_M_NETLOGON_AUTH (SERVICE_BASE + 48)
/*
* The service failed to authenticate with the primary domain controller.
*/
#define SERVICE_UIC_M_UAS_PROLOG (SERVICE_BASE + 49)
/*
* There is a problem with the security database creation date or serial number.
*/
#define SERVICE2_BASE 5600
/* new SEVICE_UIC messages go here */
#define SERVICE_UIC_M_NETLOGON_MPATH (SERVICE2_BASE + 0)
/*
* Could not share the User or Script path.
*/
#define SERVICE_UIC_M_LSA_MACHINE_ACCT (SERVICE2_BASE + 1)
/*
* The password for this computer is not found in the local security
* database.
*/
#define SERVICE_UIC_M_DATABASE_ERROR (SERVICE2_BASE + 2)
/*
* An internal error occurred while accessing the computer's
* local or network security database.
*/
//
// End modifiers
//
//
// Commonly used Macros:
//
#define SERVICE_IP_CODE(tt,nn) \
((long)SERVICE_IP_QUERY_HINT|(long)(nn|(tt<<SERVICE_IP_WAITTIME_SHIFT)))
#define SERVICE_CCP_CODE(tt,nn) \
((long)SERVICE_CCP_QUERY_HINT|(long)(nn|(tt<<SERVICE_IP_WAITTIME_SHIFT)))
#define SERVICE_UIC_CODE(cc,mm) \
((long)(((long)cc<<16)|(long)(unsigned short)mm))
//
// This macro takes a wait hint (tt) which can have a maximum value of
// 0xFFFF and puts it into the service status code field.
// 0x0FF1FFnn (where nn is the checkpoint information).
//
#define SERVICE_NT_CCP_CODE(tt,nn) \
( \
((long)SERVICE_CCP_QUERY_HINT) | \
((long)(nn)) | \
(((tt)&LOWER_HINT_MASK) << SERVICE_IP_WAITTIME_SHIFT) | \
(((tt)&UPPER_HINT_MASK) << SERVICE_NTIP_WAITTIME_SHIFT) \
)
//
// This macro takes a status code field, and strips out the wait hint
// from the upper and lower sections.
// 0x0FF1FFnn results in 0x0000FFFF.
//
#define SERVICE_NT_WAIT_GET(code) \
( \
(((code) & UPPER_GET_HINT_MASK) >> SERVICE_NTIP_WAITTIME_SHIFT) | \
(((code) & LOWER_GET_HINT_MASK) >> SERVICE_IP_WAITTIME_SHIFT) \
)
#ifdef __cplusplus
}
#endif
#endif // _LMSVC_