LMSvc.h
上传用户:dzyhzl
上传日期:2019-04-29
资源大小:56270k
文件大小:13k
- /*++ 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 LANMANLOGS 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 LANMANNETPROGADDPAK.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_