NAME
Win32::Lanman - implements MS Lanmanager functions
SYNOPSIS
use Win32::Lanman;DESCRIPTION
This module implements the MS Lanmanager functions
CONSTANTS
Documentation for use and meaning of the Constants can be found at "/search.microsoft.com/us/dev/default.asp"" in "http:
LG_INCLUDE_INDIRECT
NET_INFO_DESCRIPTION
NET_STATUS_DESCRIPTION
SERVICE_CONTROL_DESCRIPTIONS
SERVICE_STATE_DESCRIPTIONS
SERVICE_CONTROLS
SERVICE_START_TYPES
SERVICE_ERROR_TYPES
SC_FAILURE_ACTIONS
SERVICE_ACCEPTED_CONTROLS
SERVICE_ADAPTER
SERVICE_RECOGNIZER_DRIVER
SERVICE_TYPE_ALL
SV_TYPES
SERVICE_STATES
SERVICE_TYPES
WTS_STATES
SidToString
StringToSid
ACCESS_ALL
ACCESS_ATRIB
ACCESS_CREATE
ACCESS_DELETE
ACCESS_EXEC
ACCESS_PERM
ACCESS_READ
ACCESS_WRITE
AF_OP_ACCOUNTS
AF_OP_COMM
AF_OP_PRINT
AF_OP_SERVER
ALLOCATE_RESPONSE
AuditCategoryAccountLogon
AuditCategoryAccountManagement
AuditCategoryDetailedTracking
AuditCategoryDirectoryServiceAccess
AuditCategoryLogon
AuditCategoryObjectAccess
AuditCategoryPolicyChange
AuditCategoryPrivilegeUse
AuditCategorySystem
AUTH_REQ_ALLOW_ENC_TKT_IN_SKEY
AUTH_REQ_ALLOW_FORWARDABLE
AUTH_REQ_ALLOW_NOADDRESS
AUTH_REQ_ALLOW_POSTDATE
AUTH_REQ_ALLOW_PROXIABLE
AUTH_REQ_ALLOW_RENEWABLE
AUTH_REQ_ALLOW_VALIDATE
AUTH_REQ_OK_AS_DELEGATE
AUTH_REQ_PREAUTH_REQUIRED
AUTH_REQ_VALIDATE_CLIENT
Batch
DEF_MAX_PWHIST
DFS_ADD_VOLUME
DFS_RESTORE_VOLUME
DFS_STORAGE_STATE_ACTIVE
DFS_STORAGE_STATE_OFFLINE
DFS_STORAGE_STATE_ONLINE
DFS_VOLUME_STATE_INCONSISTENT
DFS_VOLUME_STATE_OK
DFS_VOLUME_STATE_OFFLINE
DFS_VOLUME_STATE_ONLINE
EVENTLOG_BACKWARDS_READ
EVENTLOG_FORWARDS_READ
EVENTLOG_SEEK_READ
EVENTLOG_SEQUENTIAL_READ
EVENTLOG_ERROR_TYPE
EVENTLOG_WARNING_TYPE
EVENTLOG_INFORMATION_TYPE
EVENTLOG_AUDIT_SUCCESS
EVENTLOG_AUDIT_FAILURE
FILTER_INTERDOMAIN_TRUST_ACCOUNT
FILTER_NORMAL_ACCOUNT
FILTER_SERVER_TRUST_ACCOUNT
FILTER_TEMP_DUPLICATE_ACCOUNT
FILTER_WORKSTATION_TRUST_ACCOUNT
IDASYNC
IDTIMEOUT
Interactive
JOB_ADD_CURRENT_DATE
JOB_EXEC_ERROR
JOB_INPUT_FLAGS
JOB_NONINTERACTIVE
JOB_OUTPUT_FLAGS
JOB_RUN_PERIODICALLY
JOB_RUNS_TODAY
KERB_CHECKSUM_CRC32
KERB_CHECKSUM_DES_MAC
KERB_CHECKSUM_DES_MAC_MD5
KERB_CHECKSUM_HMAC_MD5
KERB_CHECKSUM_KRB_DES_MAC
KERB_CHECKSUM_LM
KERB_CHECKSUM_MD25
KERB_CHECKSUM_MD4
KERB_CHECKSUM_MD5
KERB_CHECKSUM_MD5_DES
KERB_CHECKSUM_MD5_HMAC
KERB_CHECKSUM_NONE
KERB_CHECKSUM_RC4_MD5
KERB_CHECKSUM_REAL_CRC32
KERB_CHECKSUM_SHA1
KERB_DECRYPT_FLAG_DEFAULT_KEY
KERB_ETYPE_DES_CBC_CRC
KERB_ETYPE_DES_CBC_MD4
KERB_ETYPE_DES_CBC_MD5
KERB_ETYPE_DES_CBC_MD5_NT
KERB_ETYPE_DES_PLAIN
KERB_ETYPE_DSA_SIGN
KERB_ETYPE_NULL
KERB_ETYPE_PKCS7_PUB
KERB_ETYPE_RC4_HMAC_NT
KERB_ETYPE_RC4_HMAC_NT_EXP
KERB_ETYPE_RC4_HMAC_OLD
KERB_ETYPE_RC4_HMAC_OLD_EXP
KERB_ETYPE_RC4_LM
KERB_ETYPE_RC4_MD4
KERB_ETYPE_RC4_PLAIN
KERB_ETYPE_RC4_PLAIN_EXP
KERB_ETYPE_RC4_PLAIN_OLD
KERB_ETYPE_RC4_PLAIN_OLD_EXP
KERB_ETYPE_RC4_PLAIN2
KERB_ETYPE_RC4_SHA
KERB_ETYPE_RSA_PRIV
KERB_ETYPE_RSA_PUB
KERB_ETYPE_RSA_PUB_MD5
KERB_ETYPE_RSA_PUB_SHA1
KERB_RETRIEVE_TICKET_DONT_USE_CACHE
KERB_RETRIEVE_TICKET_USE_CACHE_ONLY
KERB_WRAP_NO_ENCRYPT
KERBEROS_REVISION
KERBEROS_VERSION
KerbInteractiveLogon
KerbSmartCardLogon
KerbInteractiveProfile
KerbSmartCardProfile
LG_INCLUDE_INDIRECT
LOGON_CACHED_ACCOUNT
LOGON_EXTRA_SIDS
LOGON_GRACE_LOGON
LOGON_GUEST
LOGON_NOENCRYPTION
LOGON_PROFILE_PATH_RETURNED
LOGON_RESOURCE_GROUPS
LOGON_SERVER_TRUST_ACCOUNT
LOGON_SUBAUTH_SESSION_KEY
LOGON_USED_LM_PASSWORD
LSA_MODE_INDIVIDUAL_ACCOUNTS
LSA_MODE_LOG_FULL
LSA_MODE_MANDATORY_ACCESS
LSA_MODE_PASSWORD_PROTECTED
MAJOR_VERSION_MASK
MsV1_0InteractiveLogon
MsV1_0Lm20Logon
MsV1_0NetworkLogon
MsV1_0SubAuthLogon
MsV1_0InteractiveProfile
MsV1_0Lm20LogonProfile
MsV1_0SmartCardProfile
MsV1_0EnumerateUsers
MsV1_0CacheLogon
MsV1_0CacheLookup
MsV1_0ChangeCachedPassword
MsV1_0ChangePassword
MsV1_0DeriveCredential
MsV1_0GenericPassthrough
MsV1_0GetUserInfo
MsV1_0Lm20ChallengeRequest
MsV1_0Lm20GetChallengeResponse
MsV1_0ReLogonUsers
MsV1_0SubAuth
MSV1_0_CHALLENGE_LENGTH
MSV1_0_USER_SESSION_KEY_LENGTH
MSV1_0_LANMAN_SESSION_KEY_LENGTH
MSV1_0_ALLOW_SERVER_TRUST_ACCOUNT
MSV1_0_ALLOW_WORKSTATION_TRUST_ACCOUNT
MSV1_0_CLEARTEXT_PASSWORD_ALLOWED
MSV1_0_DERIVECRED_TYPE_SHA1
MSV1_0_DONT_TRY_GUEST_ACCOUNT
MSV1_0_RETURN_PASSWORD_EXPIRY
MSV1_0_RETURN_PROFILE_PATH
MSV1_0_RETURN_USER_PARAMETERS
MSV1_0_SUBAUTHENTICATION_DLL_EX
MSV1_0_TRY_GUEST_ACCOUNT_ONLY
MSV1_0_TRY_SPECIFIED_DOMAIN_ONLY
MSV1_0_UPDATE_LOGON_STATISTICS
MSV1_0_MNS_LOGON
MSV1_0_SUBAUTHENTICATION_DLL
MSV1_0_SUBAUTHENTICATION_DLL_SHIFT
MSV1_0_SUBAUTHENTICATION_DLL_IIS
MSV1_0_SUBAUTHENTICATION_DLL_RAS
MSV1_0_SUBAUTHENTICATION_FLAGS
MSV1_0_CRED_LM_PRESENT
MSV1_0_CRED_NT_PRESENT
MSV1_0_CRED_VERSION
MSV1_0_OWF_PASSWORD_LENGTH
MSV1_0_NTLM3_OWF_LENGTH
MSV1_0_NTLM3_RESPONSE_LENGTH
MSV1_0_MAX_AVL_SIZE
MSV1_0_MAX_NTLM3_LIFE
MSV1_0_NTLM3_INPUT_LENGTH
MsvAvEOL
MsvAvNbComputerName
MsvAvNbDomainName
MsvAvDnsDomainName
MsvAvDnsServerName
NegCallPackageMax
NegEnumPackagePrefixes
NEGOTIATE_MAX_PREFIX
NETLOGON_CONTROL_BACKUP_CHANGE_LOG
NETLOGON_CONTROL_BREAKPOINT
NETLOGON_CONTROL_FIND_USER
NETLOGON_CONTROL_PDC_REPLICATE
NETLOGON_CONTROL_QUERY
NETLOGON_CONTROL_REDISCOVER
NETLOGON_CONTROL_REPLICATE
NETLOGON_CONTROL_SET_DBFLAG
NETLOGON_CONTROL_SYNCHRONIZE
NETLOGON_CONTROL_TC_QUERY
NETLOGON_CONTROL_TRANSPORT_NOTIFY
NETLOGON_CONTROL_TRUNCATE_LOG
NETLOGON_CONTROL_UNLOAD_NETLOGON_DLL
NETLOGON_FULL_SYNC_REPLICATION
NETLOGON_REDO_NEEDED
NETLOGON_REPLICATION_IN_PROGRESS
NETLOGON_REPLICATION_NEEDED
NetSetupDnsMachine
NetSetupDomain
NetSetupDomainName
NetSetupMachine
NetSetupNonExistentDomain
NetSetupUnjoined
NetSetupUnknown
NetSetupUnknownStatus
NetSetupWorkgroup
NetSetupWorkgroupName
NETSETUP_ACCT_CREATE
NETSETUP_ACCT_DELETE
NETSETUP_DOMAIN_JOIN_IF_JOINED
NETSETUP_INSTALL_INVOCATION
NETSETUP_JOIN_DOMAIN
NETSETUP_JOIN_UNSECURE
NETSETUP_WIN9X_UPGRADE
Network
NO_PERMISSION_REQUIRED
ONE_DAY
PERM_FILE_CREATE
PERM_FILE_READ
PERM_FILE_WRITE
POLICY_AUDIT_EVENT_FAILURE
POLICY_AUDIT_EVENT_NONE
POLICY_AUDIT_EVENT_MASK
POLICY_AUDIT_EVENT_NONE
POLICY_AUDIT_EVENT_SUCCESS
POLICY_AUDIT_EVENT_UNCHANGED
POLICY_ALL_ACCESS
POLICY_AUDIT_LOG_ADMIN
POLICY_CREATE_ACCOUNT
POLICY_CREATE_PRIVILEGE
POLICY_CREATE_SECRET
POLICY_EXECUTE
POLICY_GET_PRIVATE_INFORMATION
POLICY_LOOKUP_NAMES
POLICY_NOTIFICATION
POLICY_READ
POLICY_SERVER_ADMIN
POLICY_SET_AUDIT_REQUIREMENTS
POLICY_SET_DEFAULT_QUOTA_LIMITS
POLICY_TRUST_ADMIN
POLICY_VIEW_AUDIT_INFORMATION
POLICY_VIEW_LOCAL_INFORMATION
POLICY_WRITE
POLICY_QOS_ALLOW_LOCAL_ROOT_CERT_STORE
POLICY_QOS_DHCP_SERVER_ALLOWED
POLICY_QOS_INBOUND_CONFIDENTIALITY
POLICY_QOS_INBOUND_INTEGRITY
POLICY_QOS_OUTBOUND_CONFIDENTIALITY
POLICY_QOS_OUTBOUND_INTEGRITY
POLICY_QOS_RAS_SERVER_ALLOWED
POLICY_QOS_SCHANNEL_REQUIRED
PolicyAccountDomainInformation
PolicyAuditEventsInformation
PolicyAuditFullQueryInformation
PolicyAuditFullSetInformation
PolicyAuditLogInformation
PolicyDefaultQuotaInformation
PolicyDnsDomainInformation
PolicyLsaServerRoleInformation
PolicyModificationInformation
PolicyPdAccountInformation
PolicyPrimaryDomainInformation
PolicyReplicaSourceInformation
PolicyDomainEfsInformation
PolicyDomainKerberosTicketInformation
PolicyDomainQualityOfServiceInformation
PolicyNotifyAccountDomainInformation
PolicyNotifyAuditEventsInformation
PolicyNotifyDnsDomainInformation
PolicyNotifyDomainEfsInformation
PolicyNotifyDomainKerberosTicketInformation
PolicyNotifyMachineAccountPasswordInformation
PolicyNotifyServerRoleInformation
PolicyServerDisabled
PolicyServerEnabled
PolicyServerRoleBackup
PolicyServerRolePrimary
Proxy
REPL_EXTENT_FILE
REPL_EXTENT_TREE
REPL_INTEGRITY_TREE
REPL_INTEGRITY_FILE
REPL_ROLE_BOTH
REPL_ROLE_EXPORT
REPL_ROLE_IMPORT
REPL_STATE_OK
REPL_STATE_NO_MASTER
REPL_STATE_NO_SYNC
REPL_STATE_NEVER_REPLICATED
REPL_UNLOCK_FORCE
REPL_UNLOCK_NOFORCE
RESOURCE_CONNECTED
RESOURCE_GLOBALNET
RESOURCE_REMEMBERED
RESOURCETYPE_ANY
RESOURCETYPE_DISK
RESOURCETYPE_PRINT
RESOURCEDISPLAYTYPE_DOMAIN
RESOURCEDISPLAYTYPE_GENERIC
RESOURCEDISPLAYTYPE_SERVER
RESOURCEDISPLAYTYPE_SHARE
RESOURCEUSAGE_CONNECTABLE
RESOURCEUSAGE_CONTAINER
SE_GROUP_ENABLED_BY_DEFAULT
SE_GROUP_MANDATORY
SE_GROUP_OWNER
SE_CREATE_TOKEN_NAME
SE_ASSIGNPRIMARYTOKEN_NAME
SE_LOCK_MEMORY_NAME
SE_INCREASE_QUOTA_NAME
SE_UNSOLICITED_INPUT_NAME
SE_MACHINE_ACCOUNT_NAME
SE_TCB_NAME
SE_SECURITY_NAME
SE_TAKE_OWNERSHIP_NAME
SE_LOAD_DRIVER_NAME
SE_SYSTEM_PROFILE_NAME
SE_SYSTEMTIME_NAME
SE_PROF_SINGLE_PROCESS_NAME
SE_INC_BASE_PRIORITY_NAME
SE_CREATE_PAGEFILE_NAME
SE_CREATE_PERMANENT_NAME
SE_BACKUP_NAME
SE_RESTORE_NAME
SE_SHUTDOWN_NAME
SE_DEBUG_NAME
SE_AUDIT_NAME
SE_SYSTEM_ENVIRONMENT_NAME
SE_CHANGE_NOTIFY_NAME
SE_REMOTE_SHUTDOWN_NAME
SE_INTERACTIVE_LOGON_NAME
SE_DENY_INTERACTIVE_LOGON_NAME
SE_NETWORK_LOGON_NAME
SE_DENY_NETWORK_LOGON_NAME
SE_BATCH_LOGON_NAME
SE_DENY_BATCH_LOGON_NAME
SE_SERVICE_LOGON_NAME
SE_DENY_SERVICE_LOGON_NAME
Service
SC_ACTION_NONE
SC_ACTION_REBOOT
SC_ACTION_RESTART
SC_ACTION_RUN_COMMAND
SC_MANAGER_ALL_ACCESS
SC_MANAGER_CONNECT
SC_MANAGER_CREATE_SERVICE
SC_MANAGER_ENUMERATE_SERVICE
SC_MANAGER_LOCK
SC_MANAGER_MODIFY_BOOT_CONFIG
SC_MANAGER_QUERY_LOCK_STATUS
SC_STATUS_PROCESS_INFO
SERVICE_ACCEPT_STOP
SERVICE_ACCEPT_PAUSE_CONTINUE
SERVICE_ACCEPT_SHUTDOWN
SERVICE_ACCEPT_PARAMCHANGE
SERVICE_ACCEPT_NETBINDCHANGE
SERVICE_ACCEPT_HARDWAREPROFILECHANGE
SERVICE_ACCEPT_POWEREVENT
SERVICE_FILE_SYSTEM_DRIVER
SERVICE_INTERACTIVE_PROCESS
SERVICE_KERNEL_DRIVER
SERVICE_WIN32_OWN_PROCESS
SERVICE_WIN32_SHARE_PROCESS
SERVICE_AUTO_START
SERVICE_BOOT_START
SERVICE_DEMAND_START
SERVICE_DISABLED
SERVICE_SYSTEM_START
SERVICE_ERROR_CRITICAL
SERVICE_ERROR_IGNORE
SERVICE_ERROR_NORMAL
SERVICE_ERROR_SEVERE
SERVICE_CONTINUE_PENDING
SERVICE_PAUSE_PENDING
SERVICE_PAUSED
SERVICE_RUNNING
SERVICE_START_PENDING
SERVICE_STOPPED
SERVICE_STOP_PENDING
SERVICE_ALL_ACCESS
SERVICE_CHANGE_CONFIG
SERVICE_ENUMERATE_DEPENDENTS
SERVICE_INTERROGATE
SERVICE_PAUSE_CONTINUE
SERVICE_QUERY_CONFIG
SERVICE_QUERY_STATUS
SERVICE_START
SERVICE_STOP
SERVICE_USER_DEFINED_CONTROL
SERVICE_RUNS_IN_SYSTEM_PROCESS
SERVICE_CONTROL_CONTINUE
SERVICE_CONTROL_DEVICEEVENT
SERVICE_CONTROL_HARDWAREPROFILECHANGE
SERVICE_CONTROL_INTERROGATE
SERVICE_CONTROL_NETBINDADD
SERVICE_CONTROL_NETBINDDISABLE
SERVICE_CONTROL_NETBINDENABLE
SERVICE_CONTROL_NETBINDREMOVE
SERVICE_CONTROL_PAUSE
SERVICE_CONTROL_PARAMCHANGE
SERVICE_CONTROL_POWEREVENT
SERVICE_CONTROL_SHUTDOWN
SERVICE_CONTROL_STOP
SERVICE_CONFIG_FAILURE_ACTIONS
SERVICE_NO_CHANGE
SERVICE_ACTIVE
SERVICE_DRIVER
SERVICE_INACTIVE
SERVICE_STATE_ALL
SERVICE_WIN32
STYPE_DEVICE
STYPE_DISKTREE
STYPE_IPC
STYPE_PRINTQ
SUPPORTS_ANY
SUPPORTS_LOCAL
SUPPORTS_REMOTE_ADMIN_PROTOCOL
SUPPORTS_RPC
SUPPORTS_SAM_PROTOCOL
SUPPORTS_UNICODE
SV_HIDDEN
SV_MAX_CMD_LEN
SV_MAX_SRV_HEUR_LEN
SV_NODISC
SV_PLATFORM_ID_OS2
SV_PLATFORM_ID_NT
SV_SHARESECURITY
SV_TYPE_AFP
SV_TYPE_ALL
SV_TYPE_ALTERNATE_XPORT
SV_TYPE_BACKUP_BROWSER
SV_TYPE_CLUSTER_NT
SV_TYPE_DCE
SV_TYPE_DFS
SV_TYPE_DIALIN_SERVER
SV_TYPE_DOMAIN_BAKCTRL
SV_TYPE_DOMAIN_CTRL
SV_TYPE_DOMAIN_ENUM
SV_TYPE_DOMAIN_MASTER
SV_TYPE_DOMAIN_MEMBER
SV_TYPE_LOCAL_LIST_ONLY
SV_TYPE_MASTER_BROWSER
SV_TYPE_NOVELL
SV_TYPE_NT
SV_TYPE_POTENTIAL_BROWSER
SV_TYPE_PRINTQ_SERVER
SV_TYPE_SERVER
SV_TYPE_SERVER_MFPN
SV_TYPE_SERVER_NT
SV_TYPE_SERVER_OSF
SV_TYPE_SERVER_UNIX
SV_TYPE_SERVER_VMS
SV_TYPE_SQLSERVER
SV_TYPE_TERMINALSERVER
SV_TYPE_TIME_SOURCE
SV_TYPE_WFW
SV_TYPE_WINDOWS
SV_TYPE_WORKSTATION
SV_TYPE_XENIX_SERVER
SV_USERS_PER_LICENSE
SV_USERSECURITY
SV_VISIBLE
SW_AUTOPROF_LOAD_MASK
SW_AUTOPROF_SAVE_MASK
TIMEQ_FOREVER
TRUST_ATTRIBUTE_NON_TRANSITIVE
TRUST_ATTRIBUTE_TREE_PARENT
TRUST_ATTRIBUTE_TREE_ROOT
TRUST_ATTRIBUTE_UPLEVEL_ONLY
TRUST_ATTRIBUTES_USER
TRUST_ATTRIBUTES_VALID
TRUST_AUTH_TYPE_CLEAR
TRUST_AUTH_TYPE_NONE
TRUST_AUTH_TYPE_NT4OWF
TRUST_AUTH_TYPE_VERSION
TRUST_DIRECTION_BIDIRECTIONAL
TRUST_DIRECTION_DISABLED
TRUST_DIRECTION_INBOUND
TRUST_DIRECTION_OUTBOUND
TRUST_TYPE_DCE
TRUST_TYPE_DOWNLEVEL
TRUST_TYPE_MIT
TRUST_TYPE_UPLEVEL
TrustedControllersInformation
TrustedDomainAuthInformation
TrustedDomainFullInformation
TrustedDomainInformationBasic
TrustedDomainInformationEx
TrustedDomainNameInformation
TrustedPasswordInformation
TrustedPosixOffsetInformation
UAS_ROLE_STANDALONE
UAS_ROLE_MEMBER
UAS_ROLE_BACKUP
UAS_ROLE_PRIMARY
UF_ACCOUNTDISABLE
UF_DONT_EXPIRE_PASSWD
UF_HOMEDIR_REQUIRED
UF_INTERDOMAIN_TRUST_ACCOUNT
UF_LOCKOUT
UF_NORMAL_ACCOUNT
UF_PASSWD_CANT_CHANGE
UF_PASSWD_NOTREQD
UF_SCRIPT
UF_SERVER_TRUST_ACCOUNT
UF_TEMP_DUPLICATE_ACCOUNT
UF_WORKSTATION_TRUST_ACCOUNT
UNITS_PER_WEEK
Unlock
USE_FORCE
USE_LOTS_OF_FORCE
USE_NOFORCE
USE_SPECIFIC_TRANSPORT
USE_CHARDEV
USE_CONN
USE_DISCONN
USE_DISKDEV
USE_IPC
USE_NETERR
USE_OK
USE_PAUSED
USE_RECONN
USE_SESSLOST
USE_SPOOLDEV
USE_WILDCARD
USER_MAXSTORAGE_UNLIMITED
USER_PRIV_ADMIN
USER_PRIV_GUEST
USER_PRIV_USER
WNCON_DYNAMIC
WNCON_FORNETCARD
WNCON_NOTROUTED
WNCON_SLOWLINK
WTS_CURRENT_SERVER
WTS_CURRENT_SERVER_HANDLE
WTS_CURRENT_SERVER_NAME
WTS_CURRENT_SESSION
WTS_EVENT_NONE
WTS_EVENT_CREATE
WTS_EVENT_DELETE
WTS_EVENT_RENAME
WTS_EVENT_CONNECT
WTS_EVENT_DISCONNECT
WTS_EVENT_LOGON
WTS_EVENT_LOGOFF
WTS_EVENT_STATECHANGE
WTS_EVENT_LICENSE
WTS_EVENT_ALL
WTS_EVENT_FLUSH
WTS_WSD_FASTREBOOT
WTS_WSD_LOGOFF
WTS_WSD_POWEROFF
WTS_WSD_REBOOT
WTS_WSD_SHUTDOWN
WTSActive
WTSConnected
WTSConnectQuery
WTSShadow
WTSDisconnected
WTSIdle
WTSListen
WTSReset
WTSDown
WTSInit
WTSApplicationName
WTSClientAddress
WTSClientBuildNumber
WTSClientDirectory
WTSClientDisplay
WTSClientHardwareId
WTSClientName
WTSClientProductId
WTSConnectState
WTSDomainName
WTSInitialProgram
WTSOEMId
WTSSessionId
WTSUserName
WTSWinStationName
WTSWorkingDirectory
WTSUserConfigInitialProgram
WTSUserConfigWorkingDirectory
WTSUserConfigfInheritInitialProgram
WTSUserConfigfAllowLogonTerminalServer
WTSUserConfigTimeoutSettingsConnections
WTSUserConfigTimeoutSettingsDisconnections
WTSUserConfigTimeoutSettingsIdle
WTSUserConfigfDeviceClientDrives
WTSUserConfigfDeviceClientPrinters
WTSUserConfigfDeviceClientDefaultPrinter
WTSUserConfigBrokenTimeoutSettings
WTSUserConfigReconnectSettings
WTSUserConfigModemCallbackSettings
WTSUserConfigModemCallbackPhoneNumber
WTSUserConfigShadowingSettings
WTSUserConfigTerminalServerProfilePath
WTSUserConfigTerminalServerHomeDir
WTSUserConfigTerminalServerHomeDirDrive
WTSUserConfigfTerminalServerRemoteHomeDir
ACCESS_SYSTEM_SECURITY
DELETE
GENERIC_ALL
GENERIC_EXECUTE
GENERIC_READ
GENERIC_WRITE
MAXIMUM_ALLOWED
READ_CONTROL
SYNCHRONIZE
SPECIFIC_RIGHTS_ALL
STANDARD_RIGHTS_REQUIRED
STANDARD_RIGHTS_ALL
WRITE_DAC
WRITE_OWNERUseful Hashes
The following hashes are useful, since they group several associated codes form the platform sdk together, or provide description for the constants. For each hash we describe its use and mention some functions it may be used with. This is work in progress and should be finished by the next release.
- Work In progress
- %SV_TYPES
-
Descriptions of the various server types. Could be used with ....
- %SERVICE_STATES
-
Could be used with
- %SERVICE_TYPES
-
Could be used with ...
- %WTS_STATES
- %SERVICE_FAILURE_ACTIONS
-
Could be used with ....
- %SERVICE_CONTROL_DESCRIPTIONS
-
English descriptions of the service_control constants. Could be used with ....
- %SERVICE_STATE_DESCRIPTIONS
- %SERVICE_CONTROLS
- %SERVICE_START_TYPES
- %SERVICE_ERROR_TYPES
- %SC_FAILURE_ACTIONS
-
Used in ChangeServiceConfig2 and QueryServiceConfig2
- %SERVICE_ACCEPTED_CONTROLS
- %NET_INFO_DESCRIPTION
-
Used with NetUseDel, NetWkStaTransportDel, NetUseAdd , GetInfo and Enum with the flags parameter. English descriptions of the status flag (asg_type) of a NetUseAdd
- %NET_STATUS_DESCRIPTION
-
English descriptions of the status flag of a NetUseEnum or NetUseGetInfo call
- %PRIVILEGE_NAMES
-
A list of privileges which can be set or used when querying. These apply to the functions in the privileges section.
FUNCTIONS
I_NetLogonControl --- I_NetLogonControl2 --- LogonControlQuery --- LogonControlReplicate --- LogonControlSynchronize --- LogonControlPdcReplicate --- LogonControlRediscover --- LogonControlTCQuery --- LogonControlTransportNotify --- LogonControlFindUser --- NetEnumerateTrustedDomains --- I_NetGetDCList
LsaQueryInformationPolicy --- LsaSetInformationPolicy --- LsaQueryAuditLogPolicy --- LsaQueryAuditEventsPolicy --- LsaSetAuditEventsPolicy --- LsaQueryPrimaryDomainPolicy --- LsaSetPrimaryDomainPolicy --- LsaQueryPdAccountPolicy --- LsaQueryAccountDomainPolicy --- LsaSetAccountDomainPolicy --- LsaQueryServerRolePolicy --- LsaSetServerRolePolicy --- LsaQueryReplicaSourcePolicy --- LsaSetReplicaSourcePolicy --- LsaQueryDefaultQuotaPolicy --- LsaSetDefaultQuotaPolicy --- LsaQueryAuditFullPolicy --- LsaSetAuditFullPolicy --- LsaQueryDnsDomainPolicy --- LsaSetDnsDomainPolicy --- LsaQueryTrustedDomainInfo --- LsaQueryTrustedDomainNameInfo --- LsaQueryTrustedPosixOffsetInfo --- LsaQueryTrustedPasswordInfo ---
LsaEnumerateTrustedDomains --- LsaLookupNames --- LsaLookupSids --- LsaEnumerateAccountsWithUserRight --- LsaEnumerateAccountRights --- LsaAddAccountRights --- LsaRemoveAccountRights
GrantPrivilegeToAccount --- RevokePrivilegeFromAccount --- EnumAccountPrivileges --- EnumPrivilegeAccounts
NetDfsAdd --- NetDfsEnum --- NetDfsGetInfo --- NetDfsRemove --- NetDfsSetInfo --- NetDfsMove --- NetDfsRename NetDfsAddFtRoot NetDfsRemoveFtRoot NetDfsRemoveFtRootForced NetDfsAddStdRoot NetDfsAddStdRootForced NetDfsRemoveStdRoot NetDfsManagerInitialize NetDfsGetClientInfo NetDfsSetClientInfo NetDfsGetDcAddress
NetGetJoinableOUs NetGetJoinInformation NetJoinDomain NetRenameMachineInDomain NetUnjoinDomain NetValidateName NetRegisterDomainNameChangeNotification NetUnregisterDomainNameChangeNotification
NetFileClose --- NetFileEnum --- NetFileGetInfo
MultinetGetConnectionPerformance --- NetGetAnyDCName --- NetGetDCName --- NetGetDisplayInformationIndex --- NetQueryDisplayInformation
NetGroupAdd --- NetGroupAddUser --- NetGroupDel --- NetGroupDelUser --- NetGroupEnum --- NetGroupGetInfo --- NetGroupGetUsers --- NetGroupSetInfo --- NetGroupSetUsers
NetLocalGroupAdd --- NetLocalGroupAddMember --- NetLocalGroupAddMembers --- NetLocalGroupDel --- NetLocalGroupDelMember --- NetLocalGroupDelMembers --- NetLocalGroupEnum --- NetLocalGroupGetInfo --- NetLocalGroupGetMembers --- NetLocalGroupSetInfo --- NetLocalGroupSetMembers
NetMessageBufferSend --- NetMessageNameAdd --- NetMessageNameDel --- NetMessageNameEnum --- NetMessageNameGetInfo
NetRemoteTOD NetRemoteComputerSupports
NetReplExportDirAdd --- NetReplExportDirDel --- NetReplExportDirEnum --- NetReplExportDirGetInfo --- NetReplExportDirLock --- NetReplExportDirSetInfo --- NetReplExportDirUnlock --- NetReplGetInfo --- NetReplImportDirAdd --- NetReplImportDirDel --- NetReplImportDirEnum --- NetReplImportDirGetInfo --- NetReplImportDirLock --- NetReplImportDirUnlock --- NetReplSetInfo
NetScheduleJobAdd --- NetScheduleJobDel --- NetScheduleJobEnum --- NetScheduleJobGetInfo
NetServerDiskEnum --- NetServerEnum --- NetServerGetInfo --- NetServerSetInfo --- NetServerTransportAdd --- NetServerTransportDel --- NetServerTransportEnum
NetSessionDel --- NetSessionEnum --- NetSessionGetInfo
NetStatisticsGet
NetShareAdd --- NetShareCheck --- NetShareDel --- NetShareEnum --- NetShareGetInfo --- NetShareSetInfo NetConnectionEnum
NetUserAdd --- NetUserChangePassword --- NetUserDel --- NetUserEnum --- NetUserGetGroups --- NetUserGetInfo --- NetUserGetLocalGroups --- NetUserSetGroups --- NetUserSetInfo --- NetUserModalsGet --- NetUserModalsSet
NetWkstaGetInfo --- NetWkstaSetInfo --- NetWkstaTransportAdd --- NetWkstaTransportDel --- NetWkstaTransportEnum --- NetWkstaUserGetInfo --- NetWkstaUserSetInfo --- NetWkstaUserEnum
StartService --- StopService --- PauseService --- ContinueService --- InterrogateService --- ControlService --- CreateService --- DeleteService --- EnumServicesStatus --- EnumDependentServices --- ChangeServiceConfig --- GetServiceDisplayName --- GetServiceKeyName --- LockServiceDatabase --- UnlockServiceDatabase --- QueryServiceLockStatus --- QueryServiceConfig --- QueryServiceStatus --- QueryServiceObjectSecurity --- SetServiceObjectSecurity QueryServiceConfig2 ChangeServiceConfig2 QueryServiceStatusEx EnumServicesStatusEx
ReadEventLog --- GetEventDescription --- BackupEventLog --- ClearEventLog --- ReportEvent --- GetNumberOfEventLogRecords --- GetOldestEventLogRecord
WTSEnumerateServers WTSOpenServer WTSCloseServer WTSEnumerateSessions WTSEnumerateProcesses WTSTerminateProcess WTSQuerySessionInformation WTSQueryUserConfig WTSSetUserConfig WTSSendMessage WTSDisconnectSession WTSLogoffSession WTSShutdownSystem WTSWaitSystemEvent
Windows 2000
This version of Win32::Lanman now supports/implements specific calls which are only available in Windows 2000. If you call one of these routines from NT4, the call will fail and GetLastError() returns the code 127 (procedure not found).
NOTE
All of the functions return false if they fail. You can call Win32::Lanman::GetLastError() to get more error information.
Throughout $server is the name of the server you want the call to run against. If set to '', this signifies the local machine.
In previous versions of this module, you were required to put two backslashes before the server name, as you would do at the cmd prompt, but from version 1.05 all server names will be automatically prefaced by two backslashes if they are missing.
Note: Win32::Lanman defines some private error codes, which are not currently exported. You cannot call "net helpmsg" for a description of these. Instead you can find the meaning in the usererror.h file included as part of the distribution.
DFS
Here we use the term <C storage> to mean a root share, (Dfs path) associated with a Dfs link. Throughout this section if you specify a server and share the function applies to the server and share within the dfs tree. If you leave them empty, the function runs relative to the dfsroot.
NetDfsAdd($entrypath, $server, $share, [, $comment[, $flags]])
Adds a new volume to the dfs root or adds another storage to a existing dfs volume.
NetDfsEnum($server, \@dfs)
Enumerates all DFS-Entries on a DFS-Server.
NetDfsGetInfo($entrypath, $server, $share, \%dfs)
Gets information about a dfs volume. When you specify $server and $share you will get information of the volume and the specified storage. If $server and $share are empty, retrieves information for all storages in the volume.
NetDfsRemove($entrypath, $server, $share)
Removes a volume or storage space from the dfs directory; when applied to the latest storage in a volume, removes the volume from the dfs.
NetDfsSetInfo($entrypath, $server, $share, \%dfs)
Sets dfs volume information. Currently, you can only set the volume comment.
NetDfsRename($oldEntrypath, $newEntrypath)
Renames a dfs volume. Not supported in NT4.
NetDfsMove($oldEntrypath, $newEntrypath)
Moves a dfs volume. Not supported in NT4.
NetDfsAddFtRoot($server, $rootshare, $ftdfs [, $comment])
Creates the root of a new domain-based Distributed File System implementation. If the root already exists, the function adds the specified server and share to the root. This function requires Windows 2000.
NetDfsRemoveFtRoot($server, $rootshare, $ftdfs)
Removes the specified server and share from a domain-based Distributed File System root. If the share is the last associated with the Dfs root, the function also deletes the root. This function requires Windows 2000.
NetDfsRemoveFtRootForced($domain, $server, $rootshare, $ftdfs)
Removes the specified server and share from a domain-based Distributed File System root, even if the server is offline. If the share is the last associated with the Dfs root, the function also deletes the root. This function requires Windows 2000.
NetDfsAddStdRoot($server, $rootshare [, $comment])
Creates the root for a new stand-alone Distributed File System implementation. This function requires Windows 2000.
NetDfsAddStdRootForced($server, $rootshare, $store [, $comment])
Creates the root for a new stand-alone Distributed File System implementation in a cluster technology environment, allowing an offline share to host the Dfs root. This function requires Windows 2000.
NetDfsRemoveStdRoot($server, $rootshare)
Removes the server and share at the root of a stand-alone Distributed File System implementation. This function requires Windows 2000.
NetDfsManagerInitialize($server)
Reinitializes the Dfs service on the specified server. This function requires Windows 2000.
NetDfsGetClientInfo($entrypath, $server, $share, \%info)
Retrieves information about a Distributed File System link in the named Dfs root. This function requires Windows 2000.
NetDfsSetClientInfo($entrypath, $server, $share, \%info)
Associates information with a Distributed File System link in the named Dfs root. This function requires Windows 2000.
NetDfsGetDcAddress($server, \%info)
Retrieves information about a Distributed File System domain controller. This function requires Windows 2000.
DFS: EXAMPLES:
-
create new dfs volume in the dfs root
if(!Win32::Lanman::NetDfsAdd("\\\\testdfsserver\\dfsrootdir\\dfsdir", "testserver1", "testshare1", "comment", &Win32::Lanman::DFS_ADD_VOLUME)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }add an additional storage space to an existing dfs volume
if(!Win32::Lanman::NetDfsAdd("\\\\testdfsserver\\dfsrootdir\\dfsdir", "testserver2", "testshare2", "comment", &Win32::Lanman::DFS_RESTORE_VOLUME)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetDfsEnum($server, \@dfs)
-
Enumerates all directories in a dfs structure. @dfs contains all directories in the dfs root
if(!Win32::Lanman::NetDfsEnum("\\\\testserver", \@dfs)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $dfspath (@dfs) { print "${$dfspath}{'entrypath'}\t${$dfspath}{'comment'}\t${$dfspath}{'state'}\n"; if(exists(${$dfspath}{'storage'})) { $storage = ${$dfspath}{'storage'}; for($count = 0; $count <= $#$storage; $count++) { print "\t${$$storage[$count]}{'servername'}"; print "\t${$$storage[$count]}{'sharename'}"; print "\t${$$storage[$count]}{'state'}\n"; } } } -
gets information about volume \\testdfsserver\dfsrootdir\dfsdir and the storage testserver2\testshare2
if(!Win32::Lanman::NetDfsGetInfo("\\\\testdfsserver\\dfsrootdir\\dfsdir", "testserver2", "testshare2", \%dfs)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print "$dfs{'entrypath'}\t$dfs{'comment'}\t$dfs{'state'}\n"; if(exists($dfs{'storage'})) { $store = $dfs{'storage'}; for($count = 0; $count <= $#$store; $count++) { print "\t${$$store[$count]}{'servername'}"; print "\t${$$store[$count]}{'sharename'}"; print "\t${$$store[$count]}{'state'}\n"; } }gets information about volume \\testdfsserver\dfsrootdir\dfsdir and all storages in \\testdfsserver\dfsrootdir\dfsdir
if(!Win32::Lanman::NetDfsGetInfo("\\\\testdfsserver\\dfsrootdir\\dfsdir", '', '', \%dfs)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print "$dfs{'entrypath'}\t$dfs{'comment'}\t$dfs{'state'}\n"; if(exists($dfs{'storage'})) { $store = $dfs{'storage'}; for($count = 0; $count <= $#$store; $count++) { print "\t${$$store[$count]}{'server'}"; print "\t${$$store[$count]}{'share'}"; print "\t${$$store[$count]}{'state'}\n"; } } -
removes the storage testserver2\testshare2 in volume \\testdfsserver\\dfsrootdir\\dfsdir. If there is only one storage, the volume will be removed too.
if(!Win32::Lanman::NetDfsRemove("\\\\testdfsserver\\dfsrootdir\\dfsdir", "testserver2", "testshare2")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } -
Sets dfs volume comment to "this is a volume name". There is no difference, if you specify a storage or not.
if(!Win32::Lanman::NetDfsSetInfo("\\\\testdfsserver\\dfsrootdir\\dfsdir", '', '', {'comment' => 'this is a volume name'})) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } -
Creates the new dfs root testroot on the server \\testserver. It uses the share name testdfs and sets the comment test comment.
if(!Win32::Lanman::NetDfsSetInfo("\\\\testserver", "testdfs", "testroot", "test comment")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } -
Removes the dfs share testdfs from the dfs root testdfs on the server \\testserver. If testdfs is the last share in the dfs root, the function deletes the root testroot.
if(!Win32::Lanman::NetDfsRemoveFtRoot("\\\\testserver", "testdfs", "testroot")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } -
Removes the dfs share testdfs from the dfs root testroot in the domain testdomain.com, even if the dfs server which hosts the share testdfs is offline. The function will be executed on the server \\testserver. If dfstest is the last share in the dfs root, the function deletes the root testroot.
if(!Win32::Lanman::NetDfsRemoveFtRootForced("testdomain.com", "\\\\testserver", "testdfs", "testroot")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } -
Creates the root testroot for a new stand-alone Distributed File System implementation on the server \\testserver and sets the comment to test comment.
if(!Win32::Lanman::NetDfsAddStdRoot("\\\\testserver", "testroot", "test comment")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } -
Creates the root testroot for a new stand-alone Distributed File System implementation on the server \\testserver and sets the comment to test comment, even if the share does not exist.
if(!Win32::Lanman::NetDfsAddStdRootForced("\\\\testserver", "testroot", "c:\\testdir", "test comment")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } -
Removes the server/share \\testserver\\testdfs at the root of a stand-alone Distributed File System implementation.
if(!Win32::Lanman::NetDfsRemoveStdRoot("\\\\testserver", "testdfs")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetDfsManagerInitialize($server)
-
Reinitializes the Dfs service on the server \\testserver.
if(!Win32::Lanman::NetDfsManagerInitialize("\\\\testserver")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } -
Retrieves information about the \\testserver\testroot dfs root.
if(!Win32::Lanman::NetDfsGetClientInfo("\\\\testserver\\testroot", "", "", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key(sort keys info) { if($key eq "storage") { foreach $count (0 .. $#{$info{$key}}) { print "storage[$count]:\n"; foreach $skey (sort keys %{${$info{$key}}[$count]}) { print "\t$skey=${${$info{$key}}[$count]}{$skey}\n"; } } } else { print "$key=$info{$key}\n"; } }Retrieves information about the testdfs link in the \\testserver\testroot dfs root.
if(!Win32::Lanman::NetDfsGetClientInfo("\\\\testserver\\testroot", "\\\\testserver", "testdfs", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } -
Set the timeout to 200 seconds for the testdfs link in the \\testserver\testroot dfs root.
if(!Win32::Lanman::NetDfsSetClientInfo("\\\\testserver\\testroot", "\\\\testserver", "testdfs", { tomeout => 200 })) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetDfsGetDcAddress($server, \%info)
-
Retrieves information about a Distributed File System domain controller \\testserver.
if(!Win32::Lanman::NetDfsGetDcAddress("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key(sort keys info) { print "$key=$info{$key}\n"; }
Directory Services
The following functions are related to The Active Directory.
- NetGetJoinableOUs($server, $domain, $account, $password, \@ous)
-
Retrieves a list of organizational units in which a computer account can be created. This function requires Windows 2000.
- NetGetJoinInformation($server, \%info)
-
Retrieves the join status information for the specified server. This function requires Windows 2000.
- NetJoinDomain($server, $domain, $account_ou, $account, $password, $options)
-
Joins a computer to a workgroup or domain. This function requires Windows 2000.
- NetRenameMachineInDomain($server, $new_machine_name, $account, $password, $options)
-
Changes the name of a computer in a domain. This function requires Windows 2000.
- NetUnjoinDomain($server, $account, $password, $options)
-
Unjoins a computer from a workgroup or a domain. This function requires Windows 2000.
- NetValidateName($server, $name, $account, $password, $name_type)
-
Verifies the validity of a computer, workgroup or domain name. This function requires Windows 2000.
- NetRegisterDomainNameChangeNotification($notification_handle)
-
Enables an application to receive a notification when the name of the current domain changes. When the domain name changes, the specified event object is set to the signaled state. This function requires Windows 2000.
- NetUnregisterDomainNameChangeNotification($notification_handle)
-
Ends a domain name change notification started by the NetRegisterDomainNameChangeNotification function. This function requires Windows 2000.
Directory Services: EXAMPLES:
- NetGetJoinableOUs($server, $domain, $account, $password, \@ous)
-
Retrieves a list of organizational units in the domain testdomain.com in which a computer account can be created. The command is executed on the server \\testserver.
if(!Win32::Lanman::NetGetJoinableOUs("\\\\testserver", "testdomain.com", "testaccount", "testpassword", \@ous)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $ou(@ous) { print "$ou\n"; } - NetGetJoinInformation($server, \%info)
-
Retrieves the join status information for the server \\testserver.
if(!Win32::Lanman::NetGetJoinInformation("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key (sort keys %info) { print "$key=$info{$key}\n"; } - NetJoinDomain($server, $domain, $account_ou, $account, $password, $options)
-
Joins the computer \\testserver to the domain testdomain.com. The computer will be rejoined if it is already joined.
if(!Win32::Lanman::NetJoinDomain("\\\\testserver", "testdomain.com", "testou", "testaccount", "testpassword", &NETSETUP_JOIN_DOMAIN | &NETSETUP_DOMAIN_JOIN_IF_JOINED)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetRenameMachineInDomain($server, $new_machine_name, $account, $password, $options)
-
Changes the name of a the computer testserver to testcomputer in the domain.
if(!Win32::Lanman::NetRenameMachineInDomain("\\\\testserver", "testcomputer", "testaccount", "testpassword", &NETSETUP_ACCT_CREATE)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetUnjoinDomain($server, $account, $password, $options)
-
Unjoins the computer \\testserver from the domain.
if(!Win32::Lanman::NetUnjoinDomain("\\\\testserver", "testaccount", "testpassword")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetValidateName($server, $name, $account, $password, $name_type)
-
Verifies the validity of domain name testdomain.
if(!Win32::Lanman::NetValidateName("\\\\testserver", "testdomain", "testaccount", "testpassword", &NetSetupDomain)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetRegisterDomainNameChangeNotification($notification_handle)
-
Enables an application to receive a notification when the name of the current domain changes.
# you must have a valid handle # $handle = if(!Win32::Lanman::NetRegisterDomainNameChangeNotification($handle)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } # wait til the handle is signaled # WaitForSingleObject($handle) - NetUnregisterDomainNameChangeNotification($notification_handle)
-
Ends a domain name change notification started by the NetRegisterDomainNameChangeNotification function.
# you must have a valid handle # $handle = if(!Win32::Lanman::NetUnregisterDomainNameChangeNotification($handle)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }
File
- NetFileEnum($server, $basepath, $user, \@info)
-
Supplies information about some or all open files on a server.
- NetFileGetInfo($server, $fileid, \%info)
-
Retrieves information about a particular open file (specified by $fileid) resource on $server.
- NetFileClose($server, $fileid)
-
Closes a file on a server.
- NetFileEnum($server, $basepath, $user, \@info)
-
Enumerates info about some or all open files on $server.
The following sample enumerates all information about all open files on server \\testserver.
if(!Win32::Lanman::NetFileEnum("\\\\testserver", '', '', \@infos)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $info (@infos) { @keys = keys(%$info); foreach $key(@keys) { print "$key: ${$info}{$key}\n"; } print "\n"; }The following code supplies information about all open files below c:\winnt opened by user testuser on server \\testserver.
if(!Win32::Lanman::NetFileEnum("\\\\testserver", "c:\\winnt", "testuser", \@infos)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $info (@infos) { @keys = keys(%$info); foreach $key(@keys) { print "$key: ${$info}{$key}\n"; } print "\n"; } - NetFileGetInfo($server, $fileid, \%info)
-
Retrieves information about a particular file being opened on $server, fileid must be valid and obtained by NetFileEnum.
$fileid = 125; if(!Win32::Lanman::NetFileGetInfo("\\\\testserver", $fileid, \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys(%info); foreach $key(@keys) { print "$key: $info{$key}\n"; } - NetFileClose($server, $fileid)
-
As with NetFileGetInfo, fileid must be valid and obtained by NetFileEnum. The following code closes the file with fileid 125 on server \\testserver.
$fileid = 125; if(!Win32::Lanman::NetFileClose("\\\\testserver", $fileid)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }
get
- MultinetGetConnectionPerformance(\%netresource, \%info)
-
Returns information about the expected performance of a connection used to access a network resource.
- NetGetAnyDCName($server, $domain, \$dcname)
-
Returns the name of a domain controller in a specified domain. Does NOT work with Trusted Domains. You get the error code 1355 (domain doesn't exist).
In this case proceed as follows: get your pdc or a bdc and execute the NetGetAnyDCName call there.
# your primary domain name $my_domain = "my_domain"; # a trusted domain name $trust_domain = "trust_domain"; # get the pdc on your local machine for $my_domain NetGetDCName('', $my_domain, \$pdc); # now get a dc in the trusted domain NetGetAnyDCName($pdc, $trusted_domain, \$dc); - NetGetDCName($server, $domain, \$pdcname)
-
Returns the name of the primary domain controller for domain $domain.
- NetGetDisplayInformationIndex($server, $level, $prefix, \$index)
-
Gets the index of the first display information entry whose name begins with a specified string or alphabetically follows the string.
- NetQueryDisplayInformation($server, $level, $index, $entries, \@info)
-
Returns user, computer, or global group account information. The number of entries to retrieve ($entries) must be supplied and must be a decimal digit
EXAMPLES:
- MultinetGetConnectionPerformance(\%netresource, \%info)
-
Returns information about the expected performance of a connection specified in %netresource used to access a network resource. You have to specify a remote name (server and share) or a local name (redirected device name)
if(!Win32::Lanman::MultinetGetConnectionPerformance({'remotename' => "\\\\testserver\\ipc\$"}, \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys(%info); foreach $key(@keys) { print "$key: $info{$key}\n"; } if(!Win32::Lanman::MultinetGetConnectionPerformance({'localname' => "f:"}, \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys(%info); foreach $key(@keys) { print "$key: $info{$key}\n"; } - NetGetAnyDCName($server, $domain, \$dcname)
-
Returns the name of a domain controller in domain testdomain. The command will be executed on server \\testserver.
if(!Win32::Lanman::NetGetAnyDCName("\\\\testserver", "testdomain", \$dcname)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print $dcname; - NetGetDCName($server, $domain, \$pdcname)
-
Returns the name of the primary domain controller in domain testdomain. The command will be executed on server \\testserver.
if(!Win32::Lanman::NetGetDCName("\\\\testserver", "testdomain", \$pdcname)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print $pdcname; - NetGetDisplayInformationIndex($server, $level, $prefix, \$index)
-
Gets the index of the first display information entry whose name begins with test or alphabetically follows test. The command will be executed on server \\testserver. You can get an index for users accounts (pass 1), machine accounts (pass 2) or group accounts (pass 3).
if(!Win32::Lanman::NetGetDisplayInformationIndex("\\\\testserver", 1, "test", \$index)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print $index; - NetQueryDisplayInformation($server, $level, $index, $entries, \@info)
-
Returns user, computer, or global group account information. The command will be excuted on server \\testserver. A maximum of 10 accounts will be returned for each call. It starts at index 12 (every account has an index starting at 0). You can get a starting index by call NetGetDisplayInformationIndex. At first we get user accounts.
$index = 12; while(Win32::Lanman::NetQueryDisplayInformation("\\\\testserver", 1, $index, 10, \@users)) { foreach $user (@users) { print "${$user}{'name'}\t"; print "${$user}{'comment'}\t"; print "${$user}{'full_name'}\t"; print "${$user}{'flags'}\t"; print "${$user}{'user_id'}\t"; print "${$user}{'next_index'}\n"; } last if $#users == -1; $index = ${$users[$#users]}{'next_index'}; }Dito for machine accounts. Start at machines names beginning with test. We get 20 accounts on each call.
if(!Win32::Lanman::NetGetDisplayInformationIndex("\\\\testserver", 2, "test", \$index)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } while(Win32::Lanman::NetQueryDisplayInformation("\\\\testserver", 2, $index, 20, \@machines)) { foreach $machine (@machines) { print "${$machine}{'name'}\t"; print "${$machine}{'comment'}\t"; print "${$machine}{'flags'}\t"; print "${$machine}{'user_id'}\t"; print "${$machine}{'next_index'}\n"; } last if $#machines == -1; $index = ${$machines[$#machines]}{'next_index'}; }Dito for group accounts. Start at begin (index position 0). We get 5 accounts on each call.
$index = 0; while(Win32::Lanman::NetQueryDisplayInformation("\\\\testserver", 3, $index, 5, \@groups)) { foreach $group (@groups) { print "${$group}{'name'}\t"; print "${$group}{'comment'}\t"; print "${$group}{'group_id'}\t"; print "${$group}{'attributes'}\t"; print "${$group}{'next_index'}\n"; } last if $#groups == -1; $index = ${$groups[$#groups]}{'next_index'}; }
groups
- NetGroupAdd($server, $group[, $comment])
-
Creates a new global group $group on $server. An optional $comment may be specified.
- NetGroupAddUser($server, $group, $user)
-
Adds a user to a global group $group on $server.
- NetGroupDel($server, $group)
-
Deletes the global group $group on $server.
- NetGroupDelUser($server, $group, $user)
-
Deletes a user from a global group $group on server $server.
- NetGroupEnum($server, \@groups)
-
Enumerates all global groups defined on server $server. If successfull, each array element contains a hash with group name ('name'), comment ('comment'), group id ('group_id') and attributes ('attributes').
- NetGroupGetInfo($server, $group, \%info)
-
Gets the name, comment, group id and attributes of a global group, storing the result in %info ($group should be equal to $info{'name'}).
- NetGroupGetUsers($server, $group, \@users)
-
Gets the users in a global group.
- NetGroupSetInfo($server, $group, \%info)
-
Sets the name and the comment of a global group. Note if $group is set and not equal to $info{'name'}, the group will be renamed. If $info{name} is not set, only the comment will be set.
- NetGroupSetUsers($server, $group, \@users)
-
Sets the members of a global group. Note: This operation is destructive; previous users will be removed.
- NetGroupAdd($server, $group[, $comment])
-
Creates a new global group testgroup on server \\testserver. \\testserver must be a domain controller.
if(!Win32::Lanman::NetGroupAdd("\\\\testserver", "testgroup", "test group comment")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetGroupAddUser($server, $group, $user)
-
Adds a user testuser to the global group testgroup on \\testserver.
if(!Win32::Lanman::NetLocalGroupAddMembers("\\\\testserver", "testgroup", "testuser")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetGroupDel($server, $group)
-
Deletes the global group testgroup on server \\testserver.
if(!Win32::Lanman::NetLocalGroupDel("\\\\testserver", "testgroup")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetGroupDelUser($server, $group, $user)
-
Removes a user testuser from global group testgroup on server \\testserver
if(!Win32::Lanman::NetLocalGroupDelMembers("\\\\testserver", "testgroup", "testuser")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetGroupEnum($server, \@groups)
-
Retrieves all global groups on server \\testserver
if(!Win32::Lanman::NetGroupEnum("\\\\testserver", \@groups)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $group (@groups) { print "${$group}{'name'}\t${$group}{'comment'}\t${$group}{'group_id'}\t${$group}{'attributes'}\n"; } - NetGroupGetInfo($server, $group, \%info)
-
Retrieves information about the global group testgroup on server \\testserver
if(!Win32::Lanman::NetGroupGetInfo("\\\\testserver", "testgroup", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print "$info{'name'}\t$info{'comment'}\t$info{'group_id'}\t$info{'attributes'}\n"; - NetGroupGetUsers($server, $group, \@users)
-
Retrieves all user in global group testgroup on server \\testserver
if(!Win32::Lanman::NetGroupGetUsers("\\\\testserver", "testgroup", \@users)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $user (@users) { #don't print these binary data #print "${$user}{'sid'}\n"; print "${$user}{'name'}\t${$user}{'attributes'}\n"; } - NetGroupSetInfo($server, $group, \%info)
-
Sets information for the global group testgroup on server \\testserver. Only the group name and the comment can be set. Specifying a new name renames the group.
if(!Win32::Lanman::NetGroupSetInfo("\\\\testserver", "testgroup", {'name' => 'newtestgrp', 'comment' => 'comment for testgroup'})) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetGroupSetUsers($server, $group, \@users)
-
Sets user user1, user2 and user3 as members of the global group testgroup on server \\testserver. All previous group members will be removed.
if(!Win32::Lanman::NetGroupSetUsers("\\\\testserver", "testgroup", ['user1', 'user2', 'user3'])) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }
local groups
- NetLocalGroupAdd($server, $group[, $comment])
-
Creates a new local group $group on server $server. You can specify an optional comment $comment.
- NetLocalGroupAddMember($server, $group, $sid)
-
Adds users $sid to a local group on server $server.
- NetLocalGroupAddMembers($server, $group, \@members)
-
Adds members (global groups or users) to a local group $group on $server. You can specficy the users or global groups with or without domain name.
- NetLocalGroupDel($server, $group)
-
Deletes the local group $group on server $server.
- NetLocalGroupAddMember($server, $group, $sid)
-
Removes users $sid from a local group $group on server $server.
- NetLocalGroupDelMembers($server, $group, \@members)
-
Deletes members (global groups or users) of a local group $group on server $server. You can specficy the users or global groups with or without domain name.
- NetLocalGroupEnum($server, \@groups)
-
Enumerates all local groups defined on server $server. If successfull, each array element contains a hash with group name ('name') and comment ('comment').
- NetLocalGroupGetInfo($server, $group, \%info)
-
Gets the name and the comment of a local group ($group should be returned equal to $info{'name'}).
- NetLocalGroupGetMembers($server, $group, \@members)
-
Gets the members of a local group (users and global groups).
- NetLocalGroupSetInfo($server, $group, \%info)
-
Sets the name and the comment of a local group ( if $group is not equal to $info{'name'}, the group will be renamed).
- NetLocalGroupSetMembers($server, $group, \@members)
-
Sets the members of a local group (previous members will be removed). Members can be users and/or global groups.
- NetLocalGroupAdd($server, $group[, $comment])
-
Creates a new local group testgroup on server \\testserver.
if(!Win32::Lanman::NetLocalGroupAdd("\\\\testserver", "testgroup", "test group comment")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetLocalGroupAddMember($server, $group, $sid)
-
Adds testuser's $sid to the local group testgroup on server \\testserver. You must retrieve the user sid with Win32::LookupAccountName. $sid = ...
if(!Win32::Lanman::NetLocalGroupAddMember("\\\\testserver", "testgroup", $sid)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetLocalGroupAddMembers($server, $group, \@members)
-
Adds global groups (glb_grp, domain\glb_grp) and/or users (user, domain\user) to the local group testgroup on \\testserver.
unless(Win32::Lanman::NetLocalGroupAddMembers("testserver", "testgroup", ['glb_grp', 'domain\glb_grp', 'user', 'domain\user']) ) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetLocalGroupDel($server, $group)
-
Deletes the local group testgroup on server \\testserver.
unless(Win32::Lanman::NetLocalGroupDel("testserver", "testgroup")) { print 'Sorry, something went wrong; in ( Win32::Lanman::NetLocalGroupDel ) error: '; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetLocalGroupDelMember($server, $group, $sid)
-
Removes testuser's $sid from the local group testgroup on server \\testserver. You must retrieve the user sid with Win32::LookupAccountName. $sid = ...
if(!Win32::Lanman::NetLocalGroupDelMember("\\\\testserver", "testgroup", $sid)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetLocalGroupDelMembers($server, $group, \@members)
-
Removes groups (glb_grp, domain\glb_grp) and/or users (user, domain\user) from the members of the local group testgroup on \\testserver.
unless(Win32::Lanman::NetLocalGroupDelMembers("testserver", "testgroup", ['glb_grp', 'domain\glb_grp', 'user', 'domain\user']) ) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetLocalGroupEnum($server, \@groups)
-
Retrieves all local groups on server \\testserver
unless(Win32::Lanman::NetLocalGroupEnum("testserver", \@groups)) { print 'Sorry, something went wrong in (Win32::Lanman::NetLocalGroupEnum) ; error: '; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $group (@groups) { print "${$group}{'name'}\t${$group}{'comment'}\n"; } - NetLocalGroupGetInfo($server, $group, \%info)
-
Retrieves information about the local group testgroup on server \\testserver
if(!Win32::Lanman::NetLocalGroupGetInfo("\\\\testserver", "testgroup", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print "$info{'name'}\t$info{'comment'}\n"; - NetLocalGroupGetMembers($server, $group, \@members)
-
Retrieves all global groups and /or user in local group testgroup on server \\testserver
if(!Win32::Lanman::NetLocalGroupGetMembers("\\\\testserver", "testgroup", \@members)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $member (@members) { #don't print these binary data #print "${$member}{'sid'}\n"; print "${$member}{'domainandname'}\t${$member}{'sidusage'}\n"; } - NetLocalGroupSetInfo($server, $group, \%info)
-
Sets information for the local group testgroup on server \\testserver. Only the group name and the comment can be set. Since we specify a new name the group is renamed.
unless(Win32::Lanman::NetLocalGroupSetInfo("testserver", "testgroup", {'name' => 'newtestgrp', 'comment' => 'comment for testgroup'} ) ) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetLocalGroupSetMembers($server, $group, \@members)
-
Sets users (user1 and testdomain\user1) and global groups (testdomain\group1) as members of the local group testgroup on server \\testserver. All previous group members will be removed.
unless(Win32::Lanman::NetLocalGroupSetMembers("testserver", "testgroup", ['user1', 'testdomain\group1', 'testdomain\user1'] ) ) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }
Netlogon
- I_NetLogonControl($server, $function, \%info)
-
Queries, synchonizes or replicates the sam database between PDC and $server. Avoid direct calls. Use the wrapper functions below.
- I_NetLogonControl2($server, $function, $data, \%info)
-
Queries, synchonizes or replicates the sam database between PDC and $server. Queries and resets secure channels. Notifies a new transport is coming up. Finds user names. Avoid direct calls. Use the wrapper functions below.
- LogonControlQuery($server, \%info)
-
Queries the status of the sam database on $server.
- LogonControlReplicate($server, \%info)
-
Replicates the changes of the sam database on $server.
- LogonControlSynchronize($server, \%info)
-
Synchronizes the sam database between $server and a PDC.
- LogonControlPdcReplicate($server, \%info)
-
Forces all BDC's to synchronize the sam database with the PDC $server.
- LogonControlRediscover($server, $domain, \%info)
-
Resets the secure channel for a domain $domain on a server $server.
- LogonControlTCQuery($server, $domain, \%info)
-
Queries the status of the secure channel for domain $domain on a server $server.
- LogonControlTransportNotify($server, \%info)
-
Informs the server $server about the coming up of a new transport.
- LogonControlFindUser($server, $user, \%info)
-
Finds a user $user in a trusted domain. The command will be executed on server $server.
- NetEnumerateTrustedDomains($server, \@domains)
-
Enumerates all trusted domain names. The command will be executed on server $server.
- I_NetGetDCList($server, $domain, \@controllers)
-
Enumerates all domain controllers in a domain. The command will be executed on server $server.
EXAMPLES:
- I_NetLogonControl($server, $function, \%info)
-
Queries the status of \\testserver. \\testserver must be a PDC or BDC.
if(!Win32::Lanman::I_NetLogonControl("\\\\testserver", &NETLOGON_CONTROL_QUERY, \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; }Replicates the sam changes of \\testserver with the PDC. \\testserver must be a BDC.
if(!Win32::Lanman::I_NetLogonControl("\\\\testserver", &NETLOGON_CONTROL_REPLICATE, \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; }Synchronizes the sam of \\testserver with the PDC. \\testserver must be a PDC or BDC.
if(!Win32::Lanman::I_NetLogonControl("\\\\testserver", &NETLOGON_CONTROL_SYNCHRONIZE, \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; }Forces to send a synchronize request to all BDC's. \\testserver must be a PDC.
if(!Win32::Lanman::I_NetLogonControl("\\\\testserver", &NETLOGON_CONTROL_PDC_REPLICATE, \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; } - I_NetLogonControl2($server, $function, \%info)
-
Rediscovers a secure channel for domain testdomain on server \\testserver.
if(!Win32::Lanman::I_NetLogonControl2("\\\\testserver", &NETLOGON_CONTROL_REDISCOVER, "testdomain", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; }Queries the status of the secure channel for domain testdomain on server \\testserver.
if(!Win32::Lanman::I_NetLogonControl2("\\\\testserver", &NETLOGON_CONTROL_TC_QUERY, "testdomain", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; }Informs the server \\testserver about a new transport coming up.
if(!Win32::Lanman::I_NetLogonControl2("\\\\testserver", &NETLOGON_CONTROL_TRANSPORT_NOTIFY, '', \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; }Retrieves which trusted domain will log on user testuser. The command will be excuted on server \\testserver.
if(!Win32::Lanman::I_NetLogonControl2("\\\\testserver", &NETLOGON_CONTROL_FIND_USER, "testuser", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; } - LogonControlQuery($server, \%info)
-
Queries the status of \\testserver. \\testserver must be a PDC or BDC.
if(!Win32::Lanman::LogonControlQuery("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; } - LogonControlReplicate($server, \%info)
-
Replicates the sam changes of \\testserver with the PDC. \\testserver must be a BDC.
if(!Win32::Lanman::LogonControlReplicate("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; } - LogonControlSynchronize($server, \%info)
-
Synchronizes the sam of \\testserver with the PDC. \\testserver must be a PDC or BDC.
if(!Win32::Lanman::LogonControlSynchronize("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; } - LogonControlPdcReplicate($server, \%info)
-
Forces a synchronize request to be sent to all BDC's. \\testserver must be a PDC.
if(!Win32::Lanman::LogonControlPdcReplicate("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; } - LogonControlRediscover($server, $domain, \%info)
-
Rediscovers a secure channel for domain testdomain on server \\testserver.
if(!Win32::Lanman::LogonControlRediscover("\\\\testserver", "testdomain", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; } - LogonControlTCQuery($server, $domain, \%info)
-
Queries the status of the secure channel for domain testdomain on server \\testserver.
if(!Win32::Lanman::LogonControlTCQuery("\\\\testserver", "testdomain", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; } - LogonControlTransportNotify($server, \%info)
-
Informs the server \\testserver about the coming up of a new transport.
if(!Win32::Lanman::LogonControlTransportNotify("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; } - LogonControlFindUser($server, $user, \%info)
-
Retrieves which trusted domain will log on user testuser. The command will be excuted on server \\testserver.
if(!Win32::Lanman::LogonControlFindUser("\\\\testserver", "testuser", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; } - NetEnumerateTrustedDomains($server, \@domains)
-
Enumerates all trusted domain names. The command will be executed on server \\testserver.
if(!Win32::Lanman::NetEnumerateTrustedDomains("\\\\testserver", \@domains)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $domain (@domains) { print "$domain\n"; } - I_NetGetDCList($server, $domain, \@controllers)
-
Enumerates all domain controllers in the domain testdomain. The command will be executed on server \\testserver.
if(!Win32::Lanman::I_NetGetDCList("\\\\testserver", "testdomain", \@servers)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $server (@servers) { print "$server\n"; }
Message Related Functions
- NetMessageBufferSend($server, $to, $from, $message)
-
Sends a message.
- NetMessageNameAdd($server, $messagename)
-
Registers a message alias in the message name table.
- NetMessageNameAdd($server, $messagename)
-
Deletes a message alias from the table of message aliases.
- NetMessageNameEnum($server, \@info)
-
Lists the message aliases that will receive messages.
- NetMessageNameGetInfo($server, $messagename, \$info)
-
Retrieves information about a message alias in the message name table.
- NetMessageBufferSend($server, $to, $from, $message)
-
Sends the message "this is a message" from computer1 to user1. The command will be executed on \\testserver.
if(!Win32::Lanman::NetMessageBufferSend("\\\\testserver", "user1", "computer1", "this is a message")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetMessageNameAdd($server, $messagename)
-
Registers the message alias user1 in the message on server \\testserver.
if(!Win32::Lanman::NetMessageNameAdd("\\\\testserver", "testuser1")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetMessageNameDel($server, $messagename)
-
Deletes the message alias user1 in the message on server \\testserver.
if(!Win32::Lanman::NetMessageNameDel("\\\\testserver", "testuser1")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetMessageNameEnum($server, $messagename)
-
Lists the message aliases that will receive messages on server \\testserver.
if(!Win32::Lanman::NetMessageNameEnum("\\\\testserver", \@info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach (@info) { print "$_\n"; } - NetMessageNameGetInfo($server, $messagename, \$info)
-
Retrieves information about the message alias user1 in the message name table on server \\testserver.
if(!Win32::Lanman::NetMessageNameEnum("\\\\testserver", "user1", \$info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print $info;
policy
- LsaQueryInformationPolicy($server, $infotype, \%info)
-
Queries policy information. Don't call LsaQueryInformationPolicy directly. Use the LsaQueryXXXPolicy wrappers instead.
The following are equivalent, Win32::Lanman::LsaQueryInformationPolicy("", &PolicyAuditFullQueryInformation, \%info); and Win32::Lanman::LsaQueryAuditFullPolicy("", \%info);
Please use the second form , it is less prone to error.
- LsaSetInformationPolicy($server, $infotype, \%info)
-
Sets policy information. Don't call LsaSetInformationPolicy directly. Use the LsaSetXXXPolicy wrappers instead (see below).
- LsaQueryAuditLogPolicy($server, \%info)
-
Queries audit log policy information.
- LsaQueryAuditEventsPolicy($server, \%info)
-
Queries audit event policy information (if auditing is enabled and which events will be logged).
- LsaSetAuditEventsPolicy($server, \%info)
-
Sets audit event policy information.
- LsaQueryPrimaryDomainPolicy($server, \%info)
-
Queries primary domain policy information (domain name and domain sid).
- LsaSetPrimaryDomainPolicy($server, \%info)
-
Sets primary domain policy information (domain name and domain sid).
- LsaQueryPdAccountPolicy($server, \%info)
-
Queries the primary domain account used for authentication and lookup requests. It returns always an empty string. This should be a bug in the call.
- LsaQueryAccountDomainPolicy($server, \%info)
-
Queries account domain policy information (workstation name and sid).
- LsaSetAccountDomainPolicy($server, \%info)
-
Sets account domain policy information (workstation name and sid).
- LsaQueryServerRolePolicy($server, \%info)
-
Queries server role policy information (type of server: pdc, bdc).
- LsaSetServerRolePolicy($server, \%info)
-
Sets server role policy information (type of server: pdc, bdc).
- LsaQueryReplicaSourcePolicy($server, \%info)
-
Queries the replication source server (pdc) policy information.
- LsaSetReplicaSourcePolicy($server, \%info)
-
Sets the replication source server (pdc) policy information.
- LsaQueryDefaultQuotaPolicy($server, \%info)
-
Queries the default quota policy information.
- LsaSetDefaultQuotaPolicy($server, \%info)
-
Sets the default quota policy information.
- LsaQueryAuditFullPolicy($server, \%info)
-
Queries the audit full policy information (if a shutdown is raised, when the audit log is full and if the log is full).
- LsaQueryAuditFullPolicy($server, \%info)
-
Sets the audit full policy information (if a shutdown is raised, when the audit log is full).
- LsaQueryDnsDomainPolicy($server, \%info)
-
Queries the dns domain policy information. This call is only supported in nt 5 and it's not tested!
- LsaSetDnsDomainPolicy($server, \%info)
-
Sets the dns domain policy information. This call is only supported in nt 5 and it's not tested!
- LsaEnumerateTrustedDomains($server, \@domains)
-
Enumerates all trusted domains. If you execute this on a workstation or a member server, you'll get your domain and the domain sid. If you execute this on a PDC or BDC, you'll get a list of all trusted domains and their sid's.
- LsaLookupNames($server, \@accounts, \@info)
-
Looks up for account names and returns the appropriate rid, domains, sid's and domain sid's. Unlike to the LsaLookupNames api call, it returns success if at least one name could be resolved. If an account couldn't be resolved, the use flag has the value 8 (SidTypeUnknown).
- LsaLookupSids($server, \@sids, \@info)
-
Looks up for sid's and returns the appropriate names, domains, sid's and domain sid's. Unlike to the LsaLookupsids api call, it returns success if at least one sid could be resolved. If a sid couldn't be resolved, the use flag has the value 7 (SidTypeInvalid) or 8 (SidTypeUnknown).
- LsaEnumerateAccountsWithUserRight($server, $privilege, \@sids)
-
Enumerates all sids granted a privilege. To convert sid's to account names use LsaLookupSids. If the privilege is not granted to anybody, the error code is 259. This is not an error, it's by design.
- LsaEnumerateAccountRights($server, $sid, \@privileges)
-
Enumerates all privileges granted to a sid. To convert account names to sid's use LsaLookupNames. If the sid has not granted any privileges, the error code is 2. This is not an error, it's by design.
- LsaAddAccountRights($server, $sid, \@privileges)
-
Grants privileges to a sid. To convert account names to sid's use LsaLookupNames. Be really carefully with the sid. If the sid does not belong to a user, LsaAddAccountRights creates a new user without a user name.
- LsaRemoveAccountRights($server, $sid, \@privileges, [$all])
-
Removes privileges from a sid. To convert account names to sid's use LsaLookupNames. If the optional parameter $all is not null, all privileges for $sid will be removed. In this case, @privileges has no meaning. Note: there is a mistake in the documentation from Microsoft (see the platform sdk). If you remove all privileges with the $all parameter the account won't be deleted.
- LsaQueryTrustedDomainInfo($server, $domainsid, $infotype, \%info)
-
Queries information about trusted domains. Don't call LsaQueryTrustedDomainInfo directly. Use the wrappers LsaQueryTrustedXXXInfo instead.
- LsaQueryTrustedDomainNameInfo($server, $domainsid, \%info)
-
Queries the domain name info for a trusted domain.
- LsaQueryTrustedPosixOffsetInfo($server, $domainsid, \%info)
-
Queries the posix rid used to create posix users or groups for a trusted domain.
- LsaQueryTrustedPasswordInfo($server, $domainsid, \%info)
-
Queries the passwords used by trust connections for a trusted domain.
privileges
- GrantPrivilegeToAccount($server, $privilege, \@accounts)
-
Grants a privilege to users and/or groups. Avoid using GrantPrivilegeToAccount. Use LsaAddAccountRights instead.
- RevokePrivilegeFromAccount($server, $privilege, \@accounts)
-
Revokes a privilege from users and/or groups. Avoid using RevokePrivilegeFromAccount. Use LsaRemoveAccountRights instead.
- EnumAccountPrivileges($server, $account, \@privileges)
-
Enumerates privileges held by an user or group. If the user has not granted any privileges, the error code is 2. This is not an error, it's by design. Avoid using EnumAccountPrivileges. Use LsaEnumerateAccountRights instead.
- EnumPrivilegeAccounts($server, $privilege, \@accounts)
-
Enumerates all accounts (users and groups) granted a privilege. If the privilege is not granted to anybody, the error code is 259. This is not a bug, it is by design.
Avoid using EnumPrivilegeAccounts. Use LsaEnumerateAccountsWithUserRight instead.
LSA EXAMPLES:
- LsaQueryInformationPolicy($server, $infotype, \%info)
-
Queries the audit log policies on server \\testserver. Don't call LsaQueryInformationPolicy directly. Use the wrappers LsaQueryXXXPolicy instead (see examples below).
if(!Win32::Lanman::LsaQueryInformationPolicy("\\\\testserver", &PolicyAuditLogInformation, \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key(sort keys %info) { print "$key=$info{$key}\n"; } - LsaSetInformationPolicy($server, $infotype, \%info)
-
Sets the audit log policies on server \\testserver. Don't call LsaSetInformationPolicy directly. Use the wrappers LsaSetXXXPolicy instead (see examples below).
#events to audit $options[AuditCategorySystem] = &POLICY_AUDIT_EVENT_UNCHANGED; $options[AuditCategoryLogon] = &POLICY_AUDIT_EVENT_SUCCESS; $options[AuditCategoryObjectAccess] = &POLICY_AUDIT_EVENT_FAILURE; $options[AuditCategoryPrivilegeUse] = &POLICY_AUDIT_EVENT_NONE; $options[AuditCategoryDetailedTracking] = &POLICY_AUDIT_EVENT_SUCCESS | &POLICY_AUDIT_EVENT_FAILURE; $options[AuditCategoryPolicyChange] = &POLICY_AUDIT_EVENT_NONE; $options[AuditCategoryAccountManagement] = &POLICY_AUDIT_EVENT_NONE; # only valid in nt 5 $options[AuditCategoryDirectoryServiceAccess] = &POLICY_AUDIT_EVENT_NONE; $options[AuditCategoryAccountLogon] = &POLICY_AUDIT_EVENT_NONE; %info = ('auditingmode' => 1, # turn on auditing 'eventauditingoptions' => \@options # events to audit ); if(!Win32::Lanman::LsaSetInformationPolicy("\\\\testserver", PolicyAuditEventsInformation, \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - LsaQueryAuditLogPolicy($server, \%info)
-
Queries the audit log policies on server \\testserver.
if(!Win32::Lanman::LsaQueryAuditLogPolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key(sort keys %info) { print "$key=$info{$key}\n"; } - LsaQueryAuditEventsPolicy($server, \%info)
-
Queries the audit event policies on server \\testserver.
if(!Win32::Lanman::LsaQueryAuditLogPolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print "auditingmode=$info{auditingmode}\n"; print "maximumauditeventcount=$info{maximumauditeventcount}\n"; print "eventauditingoptions:\n"; if($info{maximumauditeventcount} > 0) { $options = $info{eventauditingoptions}; foreach $option (@$options) { print "\t$option\n"; } } - LsaSetAuditEventsPolicy($server, \%info)
-
Sets audit event policy information on server \\testserver.
#events to audit $options[AuditCategorySystem] = &POLICY_AUDIT_EVENT_UNCHANGED; $options[AuditCategoryLogon] = &POLICY_AUDIT_EVENT_SUCCESS; $options[AuditCategoryObjectAccess] = &POLICY_AUDIT_EVENT_FAILURE; $options[AuditCategoryPrivilegeUse] = &POLICY_AUDIT_EVENT_NONE; $options[AuditCategoryDetailedTracking] = &POLICY_AUDIT_EVENT_SUCCESS | &POLICY_AUDIT_EVENT_FAILURE; $options[AuditCategoryPolicyChange] = &POLICY_AUDIT_EVENT_NONE; $options[AuditCategoryAccountManagement] = &POLICY_AUDIT_EVENT_NONE; # only valid in nt 5 $options[AuditCategoryDirectoryServiceAccess] = &POLICY_AUDIT_EVENT_NONE; $options[AuditCategoryAccountLogon] = &POLICY_AUDIT_EVENT_NONE; %info = ('auditingmode' => 1, # turn on auditing 'eventauditingoptions' => \@options # events to audit ); if(!Win32::Lanman::LsaSetAuditEventsPolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - LsaQueryPrimaryDomainPolicy($server, \%info)
-
Queries primary domain policy information on server \\testserver.
if(!Win32::Lanman::LsaQueryPrimaryDomainPolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print "name=$info{name}\n"; print "sid=", unpack("H" . 2 * length($info{sid}), $info{sid}), "\n"; - LsaSetPrimaryDomainPolicy($server, \%info)
-
Sets the primary domain policy information for server \\testserver2 to the same like server \\testserver1.
if(!Win32::Lanman::LsaQueryPrimaryDomainPolicy("\\\\testserver1", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print "name=$info{name}\n"; print "sid=", unpack("H" . 2 * length($info{sid}), $info{sid}), "\n"; if(!Win32::Lanman::LsaSetPrimaryDomainPolicy("\\\\testserver2", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - LsaQueryPdAccountPolicy($server, \%info)
-
Queries the primary domain account used for authentication and lookup requests on server \\testserver. It returns always an empty string. This should be a bug in the call.
if(!Win32::Lanman::LsaQueryPdAccountPolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key(sort keys %info) { print "$key=$info{$key}\n"; } - LsaQueryAccountDomainPolicy($server, \%info)
-
Queries account domain policy information on server \\testserver.
if(!Win32::Lanman::LsaQueryAccountDomainPolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print "domainname=$info{domainname}\n"; print "domainsid=", unpack("H" . 2 * length($info{domainsid}), $info{domainsid}), "\n"; - LsaSetAccountDomainPolicy($server, \%info)
-
Sets account domain policy information on server \\testserver.
if(!Win32::Lanman::LsaQueryAccountDomainPolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print "domainname=$info{domainname}\n"; print "domainsid=", unpack("H" . 2 * length($info{domainsid}), $info{domainsid}), "\n";$info{domainname} = 'testserver2';
if(!Win32::Lanman::LsaSetAccountDomainPolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - LsaQueryServerRolePolicy($server, \%info)
-
Queries server role policy information on server \\testserver.
if(!Win32::Lanman::LsaQueryServerRolePolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key(sort keys %info) { print "$key=$info{$key}\n"; } - LsaSetServerRolePolicy($server, \%info)
-
Sets server role policy information to PolicyServerRoleBackup on server \\testserver.
%info = (serverrole => &PolicyServerRoleBackup); if(!Win32::Lanman::LsaQueryServerRolePolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }
- LsaQueryReplicaSourcePolicy($server, \%info)
-
Queries replication source server on server \\testserver.
if(!Win32::Lanman::LsaQueryReplicaSourcePolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key(sort keys %info) { print "$key=$info{$key}\n"; } - LsaSetReplicaSourcePolicy($server, \%info)
-
Sets replication source server to \\testserver2 on server \\testserver.
$info{replicasource} = "\\\\testserver2"; if(!Win32::Lanman::LsaSetReplicaSourcePolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - LsaQueryDefaultQuotaPolicy($server, \%info)
-
Queries the default quota policy information on server \\testserver.
if(!Win32::Lanman::LsaQueryDefaultQuotaPolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key(sort keys %info) { print "$key=$info{$key}\n"; } - LsaQueryDefaultQuotaPolicy($server, \%info)
-
Sets the default quota policy information on server \\testserver (doubles the minimum working set size).
if(!Win32::Lanman::LsaQueryDefaultQuotaPolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } $info{minimumworkingsetsize} *= 2; if(!Win32::Lanman::LsaSetDefaultQuotaPolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - LsaQueryAuditFullPolicy($server, \%info)
-
Queries the audit full policy information on server \\testserver.
if(!Win32::Lanman::LsaQueryAuditFullPolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key(sort keys %info) { print "$key=$info{$key}\n"; } - LsaSetAuditFullPolicy($server, \%info)
-
Sets the audit full policy information on server \\testserver. The server will shut down, if the audit log is full.
if(!Win32::Lanman::LsaSetAuditFullPolicy("\\\\testserver", {shutdownonfull => 1})) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - LsaQueryDnsDomainPolicy($server, \%info)
-
Queries the dns domain policy information on server \\testserver. This call is only supported in nt 5 and is currently untested!
if(!Win32::Lanman::LsaQueryDnsDomainPolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print "name=$info{name}\n"; print "dnsdomainname=$info{dnsdomainname}\n"; print "dnsforestname=$info{dnsforestname}\n"; print "guid=", unpack("H" . 2 * length($info{guid}), $info{guid}), "\n"; print "sid=", unpack("H" . 2 * length($info{sid}), $info{sid}), "\n"; - LsaQueryDnsDomainPolicy($server, \%info)
-
Sets the dns domain policy information on server \\testserver. This call is only supported in nt 5 and is currently untested!
if(!Win32::Lanman::LsaQueryDnsDomainPolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } #$info{dnsdomainname} = ... #$info{dnsforestname} = ... if(!Win32::Lanman::LsaSetDnsDomainPolicy("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - LsaEnumerateTrustedDomains($server, \@domains)
-
Shows the domain name and sid of your workstation. If you call this on any domain controller, you'll get a list of trusted domains (see the example below).
if(!Win32::Lanman::LsaEnumerateTrustedDomains("", \@domains)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $domain(@domains) { print "name=${$domain}{name}\t"; print "sid=" . unpack("H" . 2 * length(${$domain}{sid}), ${$domain}{sid}) . "\n"; }Enumerates all trusted domains of the domain testdomain.
if(!Win32::Lanman::NetGetDCName("", "testdomain", \$pdcname)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } if(!Win32::Lanman::LsaEnumerateTrustedDomains($pdcname, \@domains)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $domain(@domains) { print "name=${$domain}{name}\t"; print "sid=" . Win32::Lanman::SidToString(${$domain}{sid}) . "\n"; }Enumerate all Trusted domains for your workstation
if(!Win32::Lanman::LsaEnumerateTrustedDomains("", \@domains)) { print "Sorry, something went wrong; error: "; # get the error code #print print Win32::Lanman::GetLastError(); exit 1; } foreach my $domain (@domains) { ; exit 1; } - NetReplGetInfo($server, \%info)
-
Retrieves configuration information for the Replicator service on server \\testserver.
if(!Win32::Lanman::NetReplGetInfo("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key (@keys) { print "$key=$info{$key}\n"; } - NetReplImportDirAdd($server, $directory)
-
Registers an existing directory testimportdir in the import path of server \\testserver to be replicated.
if(!Win32::Lanman::NetReplImportDirAdd("\\\\terstserver", "testimportdir")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetReplImportDirDel($server, $directory)
-
Removes registration of replicated directory testimportdir on server \\testserver.
if(!Win32::Lanman::NetReplImportDirDel("\\\\testserver", "testimportdir")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetReplImportDirEnum($server, \@directories)
-
Lists the replicated directories in the import path on server \\testserver.
if(!Win32::Lanman::NetReplImportDirEnum("\\\\testserver", \@directories)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } data #print "$info{'security_descriptor'}\n"; -
Sets information on share testshare on server \\testserver
unless(Win32::Lanman::NetShareSetInfo("\\\\testserver", "testshare", {'remark' => 'new remark', 'max_uses' => 5})) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } -
Gets all connections made to the share testshare on server \\testserver.
if(!Win32::Lanman::NetConnectionEnum("\\\\testserver", "testshare", \%conns)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $conn(@conns) { foreach $key(sort keys %$conn) { print "$key=${$conn}{$key}\n"; } }Gets all connections made from computer testcomputer to the server testserver.
if(!Win32::Lanman::NetConnectionEnum("\\\\testserver", "\\\\testcomputer", \%conns)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $conn(@conns) { foreach $key(sort keys %$conn) { print "$key=${$conn}{$key}\n"; } }
Statistics
- NetStatisticsGet($server, $service, \%info)
-
Retrieves operating statistics for a service.
Retrieves operating statistics for the service server on server \\testserver.
if(!Win32::Lanman::NetStatisticsGet("\\\\testserver", "SERVER", \%statistics)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %statistics; foreach $key (@keys) { print "$key=$statistics{$key}\n"; }Retrieves operating statistics for the service workstation on server \\testserver.
if(!Win32::Lanman::NetStatisticsGet("\\\\testserver", "WORKSTATION", \%statistics)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %statistics; foreach $key (@keys) { print "$key=$statistics{$key}\n"; }
workstation
- NetWkstaGetInfo($server, \@info, $fullinfo)
-
Returns information about the configuration elements for a workstation.
- NetWkstaSetInfo($server, \%info)
-
Configures a workstation.
- NetWkstaTransportAdd($server, \%info)
-
Binds (or connects) the redirector to the transport.
- NetWkstaTransportDel($server, $transport, $force)
-
Unbinds the transport protocol from the redirector.
- NetWkstaTransportEnum($server, \@info)
-
Supplies information about transport protocols that are managed by the redirector.
- NetWkstaUserGetInfo(\@info)
-
Returns information about the currently logged-on user. This function must be called in the context of the logged-on user.
- NetWkstaUserSetInfo(\@info)
-
Returns information about the currently logged-on user. This function must be called in the context of the logged-on user.
- NetWkstaUserEnum($server, \@info)
-
Lists information about all users currently logged on to the workstation.
Workstation EXAMPLES:
- NetWkstaGetInfo($server, \@info, $fullinfo)
-
Returns information about the configuration elements for \\testserver.
if(!Win32::Lanman::NetWkstaGetInfo("\\\\testserver", \%info, 1)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key (@keys) { print "$key=$info{$key}\n"; } - NetWkstaSetInfo("\\\\testserver", \%info)
-
Configures \\testserver.
if(!Win32::Lanman::NetWkstaSetInfo($server, {'char_wait' => 3600, 'collection_time' => 250, 'maximum_collection_count' => 16, 'keep_conn' => 600, 'sess_timeout' => 45, 'siz_char_buf' => 512})) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetWkstaTransportAdd($server, \%info)
-
Binds (or connects) the redirector to the transport on server \\testserver.
if(!Win32::Lanman::NetWkstaTransportAdd("\\testserver" {'number_of_vcs' => 0, 'transport_address' => '000000000000', 'transport_name' => "\\Device\\NetBT_NdisWan7", 'quality_of_service' => 0xffff})) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetWkstaTransportDel($server, $transport, $force)
-
Unbinds the transport protocol from the redirector on server \\testserver.
if(!Win32::Lanman::NetWkstaTransportDel("\\\\testserver", "\\Device\\NetBT_NdisWan7", USE_FORCE)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetWkstaTransportEnum($server, \@info)
-
Supplies information about transport protocols that are managed by the redirector on server \\testserver.
if(!Win32::Lanman::NetWkstaTransportEnum("\\\\testserver", \@info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $transport (@info) { @keys = keys %$transport; foreach $key (@keys) { print "$key=#${$transport}{$key}#\n"; } } - NetWkstaUserGetInfo(\@info)
-
Returns information about the currently logged-on user. This function must be called in the context of the logged-on user.
if(!Win32::Lanman::NetWkstaUserGetInfo(\%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key (@keys) { print "$key=$info{$key}\n"; } - NetWkstaUserSetInfo(\@info)
-
Returns information about the currently logged-on user. This function must be called in the context of the logged-on user.
if(!Win32::Lanman::NetWkstaUserSetInfo({'username' => 'testuser', 'logon_domain' => 'testdomain', 'oth_domains' => 'test_oth_domain', 'logon_server' => 'logonserver'})) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetWkstaUserEnum($server, \@info)
-
Lists information about all users currently logged on \\testserver.
if(!Win32::Lanman::NetWkstaUserEnum("\\\\testserver", \@info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $user (@info) { @keys = keys %$user; foreach $key (@keys) { print "$key=#${$user}{$key}#\n"; } }
time and misc
- NetRemoteTOD($server, \%info)
-
Returns the time of day information from a specified server.
- NetRemoteComputerSupports($server, $options, \$supported)
-
Retrieves the optional features the remote server supports.
time and misc EXAMPLES:
- NetRemoteTOD($server, \%info)
-
Returns the time of day information from server \\testserver.
if(!Win32::Lanman::NetRemoteTOD("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys %info; foreach $key(@keys) { print "$key=$info{$key}\n"; } - NetRemoteComputerSupports($server, $options, \$supported)
-
Retrieves which of the options in $options are supported on server \\testserver.
if(!Win32::Lanman::NetRemoteComputerSupports("\\\\testserver", &SUPPORTS_REMOTE_ADMIN_PROTOCOL | &SUPPORTS_RPC | &SUPPORTS_SAM_PROTOCOL | &SUPPORTS_UNICODE, \$supported)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print "RAP is", ($supported & &SUPPORTS_REMOTE_ADMIN_PROTOCOL) ? "" : " not", " supported\n"; print "RPC is", ($supported & &SUPPORTS_RPC) ? "" : " not", " supported\n"; print "SAM is", ($supported & &SUPPORTS_SAM_PROTOCOL) ? "" : " not", " supported\n"; print "UNICODE is", ($supported & &SUPPORTS_UNICODE) ? "" : " not", " supported\n";
use
- NetUseAdd(\%info)
-
Establishes a connection to a shared resource.
- NetUseDel($usename, [$forcedel])
-
Deletes a connection to a shared resource.
- NetUseEnum(\@info)
-
Enumerates all connections to shared resources.
- NetUseGetInfo($usename, \%info)
-
Gets information about a connection to a shared resource.
Use EXAMPLES:
- NetUseAdd(\%info)
-
Establishes a connection to a ipc$ on server \\testserver. The connection will be established in context of user testdomain\testuser.
if(!Win32::Lanman::NetUseAdd({remote => "\\\\testserver\\ipc\$", password => "testpass", username => "testuser", domain => "testdomain", asg_type => &USE_IPC})) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }connects drive h: to \\testserver\testshare.
if(!Win32::Lanman::NetUseAdd({remote => "\\\\testserver\\testshare", local => "h:", asg_type => &USE_DISKDEV})) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }connects port lpt3: to \\testserver\testprint.
if(!Win32::Lanman::NetUseAdd({remote => "\\\\testserver\\testprint", local => "lpt3:", asg_type => &USE_SPOOLDEV})) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetUseDel($usename, [$forcedel])
-
Deletes a connection to \\testserver\testshare. If there are open files, the connection won't be closed.
if(!Win32::Lanman::NetUseDel("\\\\testserver\\testshare")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }Deletes the connection to drive h:. If there are open files, the connection will be closed.
if(!Win32::Lanman::NetUseDel("h:", &USE_FORCE)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetUseEnum(\@info)
-
Enumerates all connections to shared resources.
if(!Win32::Lanman::NetUseEnum(\@uses)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $use (@uses) { foreach (sort keys %$use) { print "$_=${$use}{$_}\n"; } } - NetUseGetInfo($usename, \%info)
-
Gets information about the to \\testserver\testshare.
if(!Win32::Lanman::NetUseGetInfo('\\\\testserver\\testshare', \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach (sort keys %info) { print "$_=$info{$_}\n"; }
User
In this section, you cannot specify a domain name for the server parameter. Instead to affect domain accounts, obtain the PDC, using NetGetDCName, and then make the calls against this server.
- NetUserAdd($server, \%user)
-
Creates a new user $user on server $server.
- NetUserChangePassword($location, $user, $oldpassword, $newpassword)
-
Changes the password for user $location\$user from $oldpassword to $newpassword. $oldpassword must be supplied, otherwise you will get error 86 (wrong password).
To Change the password for a domain account run the command on the PDC (not a BDC!).
To change a user's password without knowing the old password use NetUserSetInfo. To do this you need to have admin rights to perform the task. $location should be either a domainname (clear text) or a servername ('\\server') for local machine accounts.
Note in this function should you desire to create a local machine account you must use the "\\\\my_machine" format for $location; the module does not insert the '\\' for you for this function!
- NetUserDel($server, $user)
-
Deletes user $user on server $server.
- NetUserEnum($domain, $filter, \@user)
-
Enumerates all user in a domain or on a server.
- NetUserGetGroups($server, $user, \@groups)
-
Enumerates all global groups on server $server to which user $user belongs.
- NetUserGetInfo($server, $user, \%info)
-
Retrieves information about user $user on server $server.
- NetUserGetLocalGroups($server, $user, $flags, \@groups)
-
Enumerates all local (and global if you specify LG_INCLUDE_INDIRECT in $flags) groups on server $server to which user $user belongs.
- NetUserSetGroups($server, $user, \@groups)
-
Sets global group memberships for user $user on server $server.
- NetUserSetInfo($server, $user, \%info)
-
Sets the parameters of user $user on server $server. You cannot specify a domain name, it must be a server.
- NetUserModalsGet($server, \%info)
-
Retrieves global information for all users and global groups in the security database on server $server.
- NetUserModalsSet($server, \%info)
-
Sets global information for all users and global groups in the security database on server $server. This call is not tested!!!
- StringToSid
-
Converts a standard text format for a sid into the binary packed format used by NT internally
- SidToString
-
Converts a sid in binary format to the standard text format ( e.g. S-1-3-3479834-3464-7664)
User EXAMPLES:
-
Creates a new user testuser on server \\testserver.
if(!Win32::Lanman::NetUserAdd("\\\\testserver", {'name' => 'testuser', 'password' => 'testpassword', 'home_dir' => '\\\\testserver\\testshare', 'comment' => 'test users comment', 'flags' => UF_ACCOUNTDISABLE | UF_PASSWD_CANT_CHANGE | UF_TEMP_DUPLICATE_ACCOUNT, 'script_path' => '\\\\testserver\\testshare\\logon_script.bat', 'full_name' => 'test users full name', 'usr_comment' => 'test users usr comment', 'parms' => 'test users parameters', 'workstations' => 'comp0001,comp0002,comp0003,comp0004,comp0005,comp0006,comp0007,comp0008', 'profile' => '\\\\testserver\\testshare\\profile_dir', 'home_dir_drive' => 'Y:', 'acct_expires' => time() + 3600 * 24, 'country_code' => 49, 'code_page' => 850, 'logon_hours' => pack("b168", "000000001111111100000000" x 7), 'password_expired' => 1})) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetUserChangePassword($domain, $user, $oldpassword, $newpassword)
-
Changes user testuser's password in the domain testdomain.
if(!Win32::Lanman::NetUserChangePassword("testdomain", 'testuser', 'old_password', 'new_password')) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }Changes user testuser's password on the server \\testserver.
if(!Win32::Lanman::NetUserChangePassword("\\\\testserver", 'testuser', 'old_password', 'new_password')) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetUserDel($server, $user)
-
Deletes user testuser on server \\testserver.
if(!Win32::Lanman::NetUserDel("\\\\testserver", 'testuser')) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetUserEnum($domain, $filter, \@user)
-
Enums all user in domain testdomain. All account types will be enumerated.
if(!Win32::Lanman::NetUserEnum("testdomain", 0, \@users)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $user (@users) { $hours = unpack("b168", ${$user}{'logon_hours'}); print "${$user}{'name'}\n"; print "${$user}{'comment'}\n"; print "${$user}{'usr_comment'}\n"; print "${$user}{'full_name'}\n"; print "${$user}{'password_age'}\n"; print "${$user}{'priv'}\n"; print "${$user}{'home_dir'}\n"; print "${$user}{'flags'}\n"; print "${$user}{'script_path'}\n"; print "${$user}{'auth_flags'}\n"; print "${$user}{'parms'}\n"; print "${$user}{'workstations'}\n"; print "${$user}{'last_logon'}\n"; print "${$user}{'last_logoff'}\n"; print "${$user}{'acct_expires'}\n"; print "${$user}{'max_storage'}\n"; print "${$user}{'units_per_week'}\n"; print "$hours\n"; print "${$user}{'bad_pw_count'}\n"; print "${$user}{'num_logons'}\n"; print "${$user}{'logon_server'}\n"; print "${$user}{'country_code'}\n"; print "${$user}{'code_page'}\n"; print "${$user}{'user_id'}\n"; print "${$user}{'primary_group_id'}\n"; print "${$user}{'profile'}\n"; print "${$user}{'home_dir_drive'}\n"; print "${$user}{'password_expired'}\n"; }Enums all user on server \\testserver. Only normal accounts will be enumerated.
if(!Win32::Lanman::NetUserEnum("\\\\testserver", &FILTER_NORMAL_ACCOUNT, \@users)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $user (@users) { $hours = unpack("b168", ${$user}{'logon_hours'}); print "${$user}{'name'}\n"; print "${$user}{'comment'}\n"; print "${$user}{'usr_comment'}\n"; print "${$user}{'full_name'}\n"; print "${$user}{'password_age'}\n"; print "${$user}{'priv'}\n"; print "${$user}{'home_dir'}\n"; print "${$user}{'flags'}\n"; print "${$user}{'script_path'}\n"; print "${$user}{'auth_flags'}\n"; print "${$user}{'parms'}\n"; print "${$user}{'workstations'}\n"; print "${$user}{'last_logon'}\n"; print "${$user}{'last_logoff'}\n"; print "${$user}{'acct_expires'}\n"; print "${$user}{'max_storage'}\n"; print "${$user}{'units_per_week'}\n"; print "$hours\n"; print "${$user}{'bad_pw_count'}\n"; print "${$user}{'num_logons'}\n"; print "${$user}{'logon_server'}\n"; print "${$user}{'country_code'}\n"; print "${$user}{'code_page'}\n"; print "${$user}{'user_id'}\n"; print "${$user}{'primary_group_id'}\n"; print "${$user}{'profile'}\n"; print "${$user}{'home_dir_drive'}\n"; print "${$user}{'password_expired'}\n"; } - NetUserGetGroups($server, $user, \@groups)
-
Enums all global groups on server \\testserver to which user testuser belongs.
if(!Win32::Lanman::NetUserGetGroups("testserver", "testuser", \@groups)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $group (@groups) { print "${$group}{'name'}\n"; } - NetUserGetInfo($server, $user, \%info)
-
Retrieves information about user testuser on server \\testserver.
if(!Win32::Lanman::NetUserGetInfo("testserver", "testuser", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } $hours = unpack("b168", $user{'logon_hours'}); print "$info{'name'}\n"; print "$info{'comment'}\n"; print "$info{'usr_comment'}\n"; print "$info{'full_name'}\n"; print "$info{'password_age'}\n"; print "$info{'priv'}\n"; print "$info{'home_dir'}\n"; print "$info{'flags'}\n"; print "$info{'script_path'}\n"; print "$info{'auth_flags'}\n"; print "$info{'parms'}\n"; print "$info{'workstations'}\n"; print "$info{'last_logon'}\n"; print "$info{'last_logoff'}\n"; print "$info{'acct_expires'}\n"; print "$info{'max_storage'}\n"; print "$info{'units_per_week'}\n"; print "$hours\n"; print "$info{'bad_pw_count'}\n"; print "$info{'num_logons'}\n"; print "$info{'logon_server'}\n"; print "$info{'country_code'}\n"; print "$info{'code_page'}\n"; print "$info{'user_id'}\n"; print "$info{'primary_group_id'}\n"; print "$info{'profile'}\n"; print "$info{'home_dir_drive'}\n"; print "$info{'password_expired'}\n"; - NetUserGetLocalGroups($server, $user, $flags, \@groups)
-
Enums all local and global groups on server \\testserver to which user testuser belongs.
if(!Win32::Lanman::NetUserGetLocalGroups("\\\\testserver", "testuser", &LG_INCLUDE_INDIRECT, \@groups)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $group (@groups) { print "${$group}{'name'}\n"; } - NetUserSetGroups($server, $user, \@groups)
-
Sets global group memberships (domain users, testgroup1 and testgroup2) for user testuser on server \\testserver.
if(!Win32::Lanman::NetUserSetGroups("\\\\testserver", "testuser", ['domain users', 'testgroup1', 'testgroup2'])) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetUserSetInfo($server, $user, \%info)
-
Sets the parameters of user testuser on server \\testserver.
if(!Win32::Lanman::NetUserSetInfo("\\\\testserver", "testuser", {'name' => 'testuser', 'password' => 'testpassword', 'home_dir' => '\\\\testserver\\testshare', 'comment' => 'test users comment', 'flags' => UF_ACCOUNTDISABLE | UF_PASSWD_CANT_CHANGE | UF_TEMP_DUPLICATE_ACCOUNT, 'script_path' => '\\\\testserver\\testshare\\logon_script.bat', 'full_name' => 'test users full name', 'usr_comment' => 'test users usr comment', 'parms' => 'test users parameters', 'workstations' => 'comp0001,comp0002,comp0003,comp0004,comp0005,comp0006,comp0007,comp0008', 'profile' => '\\\\testserver\\testshare\\profile_dir', 'home_dir_drive' => 'Y:', 'acct_expires' => time() + 3600 * 24, 'country_code' => 49, 'code_page' => 850, 'logon_hours' => pack("b168", "000000001111111100000000" x 7), 'password_expired' => 1})) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - NetUserModalsGet($server, \%info)
-
Retrieves global information (account policies) for all users and global groups in the security database on server \\testserver.
if(!Win32::Lanman::NetUserModalsGet("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } @keys = keys(%info); foreach $key(@keys) { print "$key: $info{$key}\n"; } - NetUserModalsSet($server, \%info)
-
Sets global information (account policies) for all users and global groups in the security database on server \\testserver. Be really carefully in calling this. As a rule, first call NetUserModalsGet and then set the fields you want to modify. As last call NetUserModalsSet. You cannot change the domain id and the domain name.
if(!Win32::Lanman::NetUserModalsGet("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }set minimum password age to 14 days, maximum password age to 2 months, minimum password length to 8 character
$info{'min_passwd_age'} = 14 * 3600 * 24; $info{'max_passwd_age'} = 60 * 3600 * 24; $info{'min_passwd_len'} = 8; if(!Win32::Lanman::NetUserModalsSet("\\\\testserver", \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }
Services
Throughout these functions, which are used to manage services, you can specify the default service database by replacing $servicedb with the empty string (or "ServicesActive").
Currently NT supports only the default database. If you specify an invalid database name, you'll get an error 1065 (database doesn't exist).
StartService($server, $servicedb, $service)
Starts the service $service on server $server. Specify an empty string to use the default service database in $servicedb.
StopService($server, $servicedb, $service, \%status)
Stops the service $service on server $server. The service status will be returned in %status. Specify an empty string to use the default service database in $servicedb.
PauseService($server, $servicedb, $service, \%status)
Pauses the service $service on server $server. The service status will be returned in %status. Specify an empty string to use the default service database in $servicedb.
ContinueService($server, $servicedb, $service, \%status)
Continues the service $service on server $server. The service status will be returned in %status. Specify an empty string to use the default service database in $servicedb.
InterrogateService($server, $servicedb, $service, \%status)
Interrogates the service $service on server $server. The service status will be returned in %status. Specify an empty string to use the default service database in $servicedb.
ControlService($server, $servicedb, $service, $contol, \%status)
Sends a control message to the service $service on server $server. The service status will be returned in %status. Specify an empty string to use the default service database in $servicedb. $control can be one of the following commands: SERVICE_CONTROL_CONTINUE, SERVICE_CONTROL_INTERROGATE, SERVICE_CONTROL_PAUSE, SERVICE_CONTROL_STOP or a server specific control code between 128 and 255. Do not specify SERVICE_CONTROL_SHUTDOWN. To stop, continue, pause or interrogate a service, you can use the app. calls or ControlService. But you can send service specific controls between 128 and 255 to initiate a conversation with the service or something else. The most services ignore this messages.
CreateService($server, $servicedb, \%param)
Creates a service on server $server. Specify an empty string for the default service database in $servicedb. Valid keys for %param are:
name : service name
display : service display name in control panel applet
type : service type
SERVICE_WIN32_OWN_PROCESS - the service file contains only one service
SERVICE_WIN32_SHARE_PROCESS - the service file contains more services
SERVICE_KERNEL_DRIVER - the service is a kernal driver
SERVICE_FILE_SYSTEM_DRIVER - the service is a file system driver
SERVICE_INTERACTIVE_PROCESS - the service can interact with the desktop,
must be or'ed with SERVICE_WIN32_OWN_PROCESS or
SERVICE_WIN32_SHARE_PROCESS;
if your service has to interact with the desktop, it has to
run with the localsystem account
start : when to start the service
SERVICE_BOOT_START - starts at boot time (device drivers)
SERVICE_SYSTEM_START - will be started by the IoInitSystem function
(device drivers)
SERVICE_AUTO_START - will be started by the service control manager
SERVICE_DEMAND_START - will be started by calling StartService
SERVICE_DISABLED - can't be started
control :
SERVICE_ERROR_IGNORE - errors will be logged, startup will be continued
SERVICE_ERROR_NORMAL - errors will be logged, startup will be continued,
message box will pop up
SERVICE_ERROR_SEVERE - errors will be logged, startup will be continued
if the last known good configuration is started,
otherwise the system is restarted with the last
known good configuration
SERVICE_ERROR_CRITICAL - errors will be logged, startup failes if the last
known good configuration is started, otherwise
the system is restarted with the last known
good configuration
filename: path to the executable which runs for the service
group : the load ordering group of which the service is a member
tagid : unique identifier for the service in the load order group;
only valid for device drivers
dependencies array : the service will not start until all services or
load ordering groups in the dependencies array are startedaccount : account name for the service to log on as; Should be specified as one of
'domain\username' for domain accounts
or '.\usr' or 'username' for machine accounts
or 'LocalSystem'
LocalSystem is not a real account, but instead species that the service will run with "the system account".
Note if type includes SERVICE_INTERACTIVE_PROCESS then account must => 'LocalSystem'.
The account chosen requires the logon as service privilege.
password: password for account; if account =>LocalSystem, then password => ''
DeleteService($server, $servicedb, $service)
Deletes the service $service on server $server. Specify an empty string to use the default service database in $servicedb. If you delete a running service, the service will be marked as deleted, but doesn't stop the service! To stop it, call StopService.
EnumServicesStatus($server, $servicedb, $type, $state, \@services)
Enums the status of all services on server $server. Specify an empty string to use the default service database in $servicedb. Valid types are:
SERVICE_WIN32 - win32 services
SERVICE_DRIVER - kernel driverValid states are:
SERVICE_ACTIVE - active services
SERVICE_INACTIVE - inactive services
SERVICE_STATE_ALL - both of themEnumDependentServices($server, $servicedb, $service, $state, \@services)
Enums all services dependent from service in $service on server $server. Specify an empty string to use the default service database in $servicedb.
ChangeServiceConfig($server, $servicedb, $service, \%param)
Changes the service configuration to the values specified in %param for service $service on server $server. Specify an empty string to use the default service database in $servicedb. For a description of %param, see CreateService.
GetServiceDisplayName($server, $servicedb, $service, \$display)
Obtains the service display name of service $service on server $server. Specify an empty string to use the default service database in $servicedb.
GetServiceKeyName($server, $servicedb, $display, \$service)
Obtains the service name from the service display name $display on server $server. Specify an empty string to use the default service database in $servicedb.
LockServiceDatabase($server, $servicedb, \$lock)
Locks the service control manager database on server $server. Only one process can lock the database at a given time. LockServiceDatabase prevents the service control manager from starting services. You have to call UnlockServiceDatabase to unlock the database. Specify an empty string to use the default service database in $servicedb.
UnlockServiceDatabase($server, $servicedb, $lock)
Unlocks the service control manager database on server $server by releasing the lock $lock. Specify an empty string to use the default service database in $servicedb.
QueryServiceLockStatus($server, $servicedb, \%lock)
Retrieves the lock status of the service control manager database on server $server. Specify an empty string to use the default service database in $servicedb.
QueryServiceConfig($server, $servicedb, $service, \%config)
Retrieves the configuration parameters of the service $service on server $server. Specify an empty string to use the default service database in $servicedb.
QueryServiceStatus($server, $servicedb, $service, \%status)
Retrieves the current status of the service $service on server $server. Specify an empty string to use the default service database in $servicedb.
QueryServiceObjectSecurity($server, $servicedb, $service, $securityinformation, \$securitydescriptor)
Retrieves a security descriptor associated with the service $service on server $server. $securityinformation specifies the requested security information. Valid security informations are OWNER_SECURITY_INFORMATION, GROUP_SECURITY_INFORMATION, DACL_SECURITY_INFORMATION and SACL_SECURITY_INFORMATION. To get SACL_SECURITY_INFORMATION, the calling process needs the SeSecurityPrivilege privilege enabled. Specify an empty string to use the default service database in $servicedb.
SetServiceObjectSecurity($server, $servicedb, $service, $securityinformation, $securitydescriptor)
Sets a security descriptor of the service $service on server $server. $securityinformation specifies the security information to set. Valid security informations are OWNER_SECURITY_INFORMATION, GROUP_SECURITY_INFORMATION, DACL_SECURITY_INFORMATION and SACL_SECURITY_INFORMATION. $securitydescriptor must be a valid security descriptor.
Note: Be careful when using this call, since if you revoke access to everyone, then nobody will be able to control the service. Also if you can grant the SERVICE_START and SERVICE_STOP rights to the everyone group, any people can start and stop your service (as default only administrators and power user can do this). Specify an empty string to use the default service database in $servicedb.
QueryServiceConfig2($server, $servicedb, $service, \%config)
Retrieves the optional configuration parameters of the service $service from the $servicedb database. This function requires Windows 2000.
ChangeServiceConfig2($server, $servicedb, $service, \%config)
Changes the optional configuration parameters of the service $service from the $servicedb database. This function requires Windows 2000.
QueryServiceStatusEx($server, $servicedb, $service, \%status)
Retrieves the current status of the specified service. This function requires Windows 2000.
EnumServicesStatusEx($server, $servicedb, $type, $state, \@services [, $group])
Enumerates services in the specified service control manager database. Filtering is done on type, state and group. The group parameter is optional. If you omit the group parameter, the function returns all services filtered only on type and state. This function requires Windows 2000.
Services EXAMPLES
- StartService($server, $servicedb, $service)
-
Starts the schedule service on server \\testserver.
if(!Win32::Lanman::StartService("testserver", '', "schedule")) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - StopService($server, $servicedb, $service, \%status)
-
Stops the schedule service on server \\testserver and prints the status flags.
if(!Win32::Lanman::StopService("testserver", '', "schedule", \%status)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }for $keyeach (sort keys %status) { print "$key = $status{$key}\n"; }
- PauseService($server, $servicedb, $service, \%status)
-
Pauses the schedule service on server \\testserver and prints the status flags.
if(!Win32::Lanman::PauseService("\\\\testserver", '', "schedule", \%status)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } for $keyeach (sort keys %status) { print "$key = $status{$key}\n"; } - ContinueService($server, $servicedb, $service, \%status)
-
Continues the schedule service on server \\testserver and prints the status flags.
if(!Win32::Lanman::ContinueService("\\\\testserver", '', "schedule", \%status)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } for $keyeach (sort keys %status) { print "$key = $status{$key}\n"; } - InterrogateService($server, $servicedb, $service, \%status)
-
Interrogates the schedule service on server \\testserver and prints the status flags.
if(!Win32::Lanman::InterrogateService("\\\\testserver", '', "schedule", \%status)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key (sort keys %status) { print "$key = $status{$key}\n"; } - ControlService($server, $servicedb, $service, $contol, \%status)
-
Stops the schedule service on server \\testserver and prints the status flags.
if(!Win32::Lanman::ControlService("\\\\testserver", '', "schedule", &SERVICE_CONTROL_STOP, \%status)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key (sort keys %status) { print "$key = $status{$key}\n"; }Sends the value 130 to the service myservice on server \\testserver and prints the status flags.
if(!Win32::Lanman::ControlService("\\\\testserver", '', "myservice", 130, \%status)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key (sort keys %status) { print "$key = $status{$key}\n"; } - CreateService($server, $servicedb, \%param)
-
Creates the service myservice on server \\testserver. The display name is 'my first service'. The service logs on with the testdomain\testuser account. We have to grant the logon as service right. The service doesn't have dependencies. It will belong to the load ordering group 'myservices'
if(!Win32::Lanman::GrantPrivilegeToAccount("\\\\testserver", "SeServiceLogonRight", ['testdomain\\testuser']) || !Win32::Lanman::CreateService("\\\\testserver", '', { name => 'myservice' display => 'my first service', type => &SERVICE_WIN32_OWN_PROCESS, start => &SERVICE_AUTO_START, control => &SERVICE_ERROR_NORMAL, filename => "C:\\WINNT\\system32\\myservice.exe", group => 'myservices', account => 'testdomain\\testuser', password => 'testpass'})) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }Creates the next service myservice2 on server \\testserver. The display name is 'my next service'. The service logs on with the LocalSystem account (this is because account and password are missing, so LocalSystem is the default). The service has no dependencies or load ordering group. The service can have more than one service in the same file and it can interact with the desktop.
if(!Win32::Lanman::CreateService("\\\\testserver", '', { name => 'myservice2' display => 'my next service', type => &SERVICE_WIN32_SHARE_PROCESS | &SERVICE_INTERACTIVE_PROCESS, start => &SERVICE_DEMAND_START, control => &SERVICE_ERROR_IGNORE, filename => "C:\\WINNT\\system32\\mysrv_x.exe"})) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }Creates the 3rd service myservice3 on server \\testserver. The display name is 'my 3rd service'. The service logs on with the LocalSystem account. The service doesn't have dependencies or a load ordering group. The service may have more than one service in the same file.
if(!Win32::Lanman::CreateService("\\\\testserver", '', { name => 'myservice3' display => 'my 3rd service', type => &SERVICE_WIN32_SHARE_PROCESS, start => &SERVICE_DEMAND_START, control => &SERVICE_ERROR_IGNORE, filename => "C:\\WINNT\\system32\\mysrv_x.exe", account => 'LocalSystem', password = ''})) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }Creates the 4th service myservice3 on server \\testserver. The display name is 'my 4th service'. The service logs on with the LocalSystem account. The service has dependencies (two services and one load ordering group). The service can interact with the desktop.
if(!Win32::Lanman::CreateService("\\\\testserver", '', { name => 'myservice4', display => 'my 4th service', type => &SERVICE_WIN32_OWN_PROCESS | &SERVICE_INTERACTIVE_PROCESS, start => &SERVICE_DEMAND_START, control => &SERVICE_ERROR_IGNORE, filename => "C:\\WINNT\\system32\\mysrv4.exe", dependencies => ['myservice2', 'myservice2', 'myservices'] })) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - DeleteService($server, $servicedb, $service)
-
Deletes the service 'myservice' on server \\testserver.
if(!Win32::Lanman::DeleteService("\\\\testserver", '', 'myservice')) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - EnumServicesStatus($server, $servicedb, $type, $state, \@services)
-
Enums the status of all normal services on server \\testserver.
if(!Win32::Lanman::EnumServicesStatus("\\\\testserver", "", &SERVICE_WIN32, &SERVICE_STATE_ALL, \@services)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $service (@services) { print "${$service}{name}\n"; foreach $key (sort keys %$service) { print "\t$key = ${$service}{$key}\n" if $key ne 'name'; } }Enums the status of all active kernel drivers on server \\testserver.
if(!Win32::Lanman::EnumServicesStatus("\\\\testserver", "", &SERVICE_DRIVER, &SERVICE_ACTIVE, \@services)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $service (@services) { print "${$service}{name}\n"; foreach $key (sort keys %$service) { print "\t$key = ${$service}{$key}\n" if $key ne 'name'; } } - EnumDependentServices($server, $servicedb, $service, $state, \@services)
-
Enums the name and status of all services depend on service LanmanWorkstation on server \\testserver.
if(!Win32::Lanman::EnumDependentServices("\\\\testserver", "", 'LanmanWorkstation', &SERVICE_STATE_ALL, \@services)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $service (@services) { print "${$service}{name}\n"; foreach $key (sort keys %$service) { print "\t$key = ${$service}{$key}\n" if $key ne 'name'; } } - ChangeServiceConfig($server, $servicedb, $service, \%param)
-
Changes the service configuration for service myservice on server \\testserver. You have to specify only the properties you want to change. All the others remain their values. In this example, we only change the display and account information. Don't forget to grant the logon as service right to testdomain\testuser. See also CreateService examples.
if(!Win32::Lanman::ChangeServiceConfig("\\\\testserver", '', { name => 'myservice' display => 'a new display name', account => 'testdomain\\testuser', password => 'testpass'})) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - GetServiceDisplayName($server, $servicedb, $service, \$display)
-
Obtains the service display name of service myservice on server \\testserver.
if(!Win32::Lanman::GetServiceDisplayName("\\\\testserver", "", 'myservice', \$display)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print $display; - GetServiceKeyName($server, $servicedb, $display, \$service)
-
Obtains the service name from the service display name 'my newest service' on server \\testserver.
if(!Win32::Lanman::GetServiceKeyName("\\\\testserver", "", 'my newest service', \$service)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print $service; - LockServiceDatabase($server, $servicedb, \$lock)
-
Locks the service control manager database on server \\testserver. If locked, do any stuff and the unlock the database.
if(!Win32::Lanman::LockServiceDatabase("\\\\testserver", "", \$lock)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } # do any stuff here... if(!Win32::Lanman::UnlockServiceDatabase("\\\\testserver", "", $lock)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - UnlockServiceDatabase($server, $servicedb, $lock)
-
Unlocks the service control manager database on server \\testserver. See the example above.
- QueryServiceLockStatus($server, $servicedb, \%lock)
-
Retrieves the lock status of the service control manager database on server \\testserver.
if(!Win32::Lanman::QueryServiceLockStatus("\\\\testserver", "", \%lock)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } for $key (sort keys %lock) { print "$key = $lock{$key}\n"; } - QueryServiceConfig($server, $servicedb, $service, \%config)
-
Retrieves the configuration parameters of the service myservice on server \\testserver.
if(!Win32::Lanman::QueryServiceConfig("\\\\testserver", '', 'myservice', \%config)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } for $key (sort keys %config) { if($key eq "dependencies") { $dependencies = $config{$key}; print "\t$key = ", $#$dependencies + 1, "\n"; foreach $dependency (@$dependencies) { print "\t\t$dependency\n"; } } else { print "\t$key = $config{$key}\n"; } } - QueryServiceStatus($server, $servicedb, $service, \%status)
-
Retrieves the current status of the service myservice on server \\testserver.
if(!Win32::Lanman::QueryServiceStatus("\\\\testserver", "", 'myservice', \%status)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }for $key (sort keys %status) { print "$key = $status{$key}\n"; }
- QueryServiceObjectSecurity($server, $servicedb, $service, $securityinformation, \$securitydescriptor)
-
Retrieves a security descriptor associated with the service $service on server $server. OWNER_SECURITY_INFORMATION, GROUP_SECURITY_INFORMATION, DACL_SECURITY_INFORMATION and SACL_SECURITY_INFORMATION will be retrieved.
$securityinformation = &OWNER_SECURITY_INFORMATION | &GROUP_SECURITY_INFORMATION | &DACL_SECURITY_INFORMATION | &SACL_SECURITY_INFORMATION; if(!Win32::Lanman::QueryServiceObjectSecurity("\\\\testserver", "", 'myservice', $securityinformation, \$securitydescriptor)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } #Do not print these binary data. #print $securitydescriptor; - SetServiceObjectSecurity($server, $servicedb, $service, $securityinformation, $securitydescriptor)
-
Sets a security descriptor of the service myservice on server \\testserver. Only DACL_SECURITY_INFORMATION will be set. You have to build a valid security descriptor in $securitydescriptor.
#build a valid security descriptor #$securitydescriptor = ... if(!Win32::Lanman::SetServiceObjectSecurity("\\\\testserver", "", 'myservice', &DACL_SECURITY_INFORMATION, $securitydescriptor)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - QueryServiceConfig2($server, $servicedb, $service, \%config)
-
Retrieves the optional configuration parameters of the service testserv on the server \\testserver.
if(!Win32::Lanman::QueryServiceConfig2("\\\\testserver", "", 'testserv', \%config)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key (sort keys %config) { print "$key = $config{$key}\n"; } - ChangeServiceConfig2($server, $servicedb, $service, \%config)
-
Changes the optional configuration parameters of the service testserv on server \\testserver. Unfortunately, you cannot configure the actions parameters. I don't know why, but the call fails as soon as the actions parameter is specified.
$config{description} = 'This is a service description'; $config{command} = 'c:\\winnt\\system32\\notepad.exe'; $config{rebootmsg} = 'This is a reboot message'; $config{resetperiod} = 100; #@actions = ({type => &SC_ACTION_NONE, delay => 1000}, # {type => &SC_ACTION_REBOOT, delay => 2000}, # {type => &SC_ACTION_RESTART, delay => 3000}, # {type => &SC_ACTION_RUN_COMMAND, delay => 4000}); #$config{actions} = \@actions; if(!Win32::Lanman::ChangeServiceConfig2("\\\\testserver", "", 'testserv', \%config)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - QueryServiceStatusEx($server, $servicedb, $service, \%status)
-
Retrieves the current status of the service testserv on the server \\testserver.
if(!Win32::Lanman::QueryServiceStatusEx("\\\\testserver", "", 'testserv', \%status)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key (sort keys %status) { print "\t$key = $status{$key}\n"; } - EnumServicesStatusEx($server, $servicedb, $type, $state, \@services [, $group])
-
Enumerates all services belonging to the group testgroup on the server \\testserver.
if(!Win32::Lanman::EnumServicesStatusEx("\\\\testserver", "", &SERVICE_WIN32 | &SERVICE_DRIVER, &SERVICE_STATE_ALL, \%services, 'testgroup')) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $service (@services) { foreach $key (sort keys %$service) { print "\t$key = ${$service}{$key}\n"; } }
eventlog
Throughout this section $source will represent the event log source, which can only be "application" or "system" or "security".
ReadEventLog($server, $source, $first, $last, \@events)
Reads events in the range from $first to $last from the event log $source on server $server in the order $first to $last. So y ou can read forward ,when $first <= $last, or backward , by having $first > $last. Sequential reads as with NT EventViewer's Next and Previous buttons, are not supported. This is because after each call the event log is closed.
To get all events set $first to 1 and $last to -1 (or 0xffffffff if you prefer).
GetEventDescription($server, \%event)
Retrieves the description of the event %event on server $server. %event must be retrieved by a ReadEventLog call.
ClearEventLog($server, $source [, $filename])
Clears the eventlog $source on server $server and makes an optionally backup to file $filename before clearing. ClearEventLog will fail with error 183 (couldn't create existing file). In this case, the eventlog will not be cleared.
BackupEventLog($server, $source, $filename)
Makes a backup from the eventlog $source on server $server to file $filename. As with ClearEventLog, BackupEventLog fails if filename exists.
ReportEvent($server, $source, $type, $category, $id, $sid, \@strings, $data)
Writes an event to the event log $source on server $server.
GetNumberOfEventLogRecords($server, $source, \$numrecords)
Retrieves the number of records in the event log $source on server $server.
GetOldestEventLogRecord($server, $source, \$oldestrecord)
Retrieves the oldest record number in the event log $source on server $server.
EventLog EXAMPLES:
- ReadEventLog($server, $source, $first, $last, \@events)
-
Reads all events from the system event log in the range from the first to the last event on server \\testserver.
if(!Win32::Lanman::ReadEventLog("testserver", 'system', 0, 0xffffffff, \@events)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }Reads all events from the security event log in reverse order on server \\testserver.
if(!Win32::Lanman::ReadEventLog("\\\\testserver", 'security', 0xffffffff, 0, \@events)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }Retrieves the first and the last record number in the application log on server \\testserver. Then it reads all these events and prints out the event properties.
if(!Win32::Lanman::GetOldestEventLogRecord("testserver", 'application', \$first)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } if(!Win32::Lanman::GetNumberOfEventLogRecords("testserver", 'application', \$last)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } $last += $first - 1; if(!Win32::Lanman::ReadEventLog("testserver", 'application', $first, $last, \@events)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $event(@events) { #get the event description for the event ${$event}{'eventdescription'} = "*** Error get event description ***" if !Win32::Lanman::GetEventDescription("\\\\testserver", $event); ${$event}{'eventdescription'} = join('', split(/\r/, ${$event}{'eventdescription'})); ${$event}{'eventdescription'} = join('', split(/\n/, ${$event}{'eventdescription'})); print '#' x 80; @keys = sort keys %$event; foreach $key(@keys) { if($key eq 'strings') { $strings = ${$event}{$key}; print "strings\n"; foreach $string(@$strings) { print "\t$string\n"; } } elsif($key eq 'eventid') { #this is the event id you'll see in event viewer; the highest 16 bit are discarded print "$key=" . (${$event}{$key} & 0xffff) . "\n"; #this is the real event id #print "$key=" . (${$event}{$key}) . "\n"; } elsif($key eq 'timegenerated' || $key eq 'timewritten') { print "$key=" . localtime(${$event}{$key}) . "\n"; } elsif($key eq 'usersid' || $key eq 'data') { print "$key=" . unpack("H" . 2 * length(${$event}{$key}), ${$event}{$key}) . "\n"; } else { print "$key=${$event}{$key}\n"; } } } - GetEventDescription($server, \%event)
-
Retrieves all records in the system log on server \\testserver. Then it reads all these events and prints out the event descriptions.
if(!Win32::Lanman::ReadEventLog("\\\\testserver", 'system', 0, -1, \@events)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $event(@events) { #get the event description for the event ${$event}{'eventdescription'} = "*** Error get event description ***" if !Win32::Lanman::GetEventDescription("\\\\testserver", $event); print ${$event}{'eventdescription'}; } - BackupEventLog($server, $source, $filename)
-
Makes a backup from the application eventlog on server \\testserver to the file application.evt.
if(!Win32::Lanman::BackupEventLog("\\\\testserver", 'application', 'application.evt')) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - ClearEventLog($server, $source [, $filename])
-
Makes a backup from the application eventlog on server \\testserver to the file application.evt. Thereafter the application event log will be cleared.
if(!Win32::Lanman::ClearEventLog("\\\\testserver", 'application', 'application.evt')) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }Clears the system eventlog on server \\testserver without backing up the events.
if(!Win32::Lanman::ClearEventLog("\\\\testserver", 'system')) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - ReportEvent($server, $source, $type, $category, $id, $sid, \@strings, $data)
-
Reports an event to the event log on server \\testserver.
#build administrators sid $sid = pack("C16", 1, 2, 0, 0, 0, 0, 0, 5, 32, 0, 0, 0, 32, 2, 0 , 0); unless(Win32::Lanman::ReportEvent("\\\\testserver", 'Print', &EVENTLOG_ERROR_TYPE, 100, 256, $sid, ['string1', 'string2', 'string3'], 'Here is my data ...') ) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - GetNumberOfEventLogRecords($server, $source, \$numrecords)
-
Retrieves the number of records in the event log system on server \\testserver.
if(!Win32::Lanman::GetNumberOfEventLogRecords("\\\\testserver", 'system', \$numrecords)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print "$numrecords\n"; - GetOldestEventLogRecord($server, $source, \$oldestrecord)
-
Retrieves the oldest record number in the event log system on server \\testserver.
if(!Win32::Lanman::GetOldestEventLogRecord("\\\\testserver", 'system', \$oldestrecord)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print "$oldestrecord\n";
windows terminal server
- Note:
-
The WTS dll (wtsapi32.dll) is not an integral part of Windows NT. The Lanman module tries to loads the dll dynamically when your script starts. The dll is not statically linked. If the dll is present and can be loaded, then you can call the WTS functions. But if the dll cannot be loaded, every WTS call fails. GetLastError() returns 126 (ERROR_MOD_NOT_FOUND). Wtsapi32.dll needs three additional dlls: utildll.dll, regapi.dll and winsta.dll. Copy each of these dlls into your system32 directory.
- WTSEnumerateServers($domain, \@sessions)
-
Enumerates all WTS server in domain.
- WTSOpenServer($server, \$handle)
-
Opens an handle on a WTS server.
This call is not really necessary and only implemented for completeness and for those keenly interested in performance. With the WTS api you have to open a server handle, then call your WTS function and close the handle with WTSCloseServer at the end. The module opens the handle every time you call a WTS function, makes the job and closes the handle at the end. The advantage: you don't need to deal with handles, the downside: the overhead in opening and closing a handle at each call.
- WTSCloseServer($handle)
-
Closes an handle on a WTS server. This call is not really necessary and only implemented for completeness. See also the remarks at WTSOpenServer.
- WTSEnumerateSessions($server, \@sessions)
-
Enumerates sessions on a WTS server.
- WTSEnumerateProcesses($server, \@processes)
-
Enumerates processes on a WTS server.
- WTSTerminateProcess($server, $processid [, $exitcode])
-
Terminates a process on a WTS server.
- WTSQuerySessionInformation($server, $sessionid, \@infoclass, \%info)
-
Returns information about the specified session on a WTS server. You need to specify which information you are interested in. To get all information available, use WTSInfoClassAll() as @infoclass parameter.
- WTSQueryUserConfig($server, $user, \@infoclass, \%config)
-
Returns the WTS user properties. Call this on your domains primary domain controller. You need to specify which information you are interested in. To get all information available, use WTSUserConfigAll() as @infoclass parameter.
- WTSSetUserConfig($server, $user, \%config)
-
Sets the WTS user properties. Call this on your primary domain controller. The function sets all information contained in the %config hash.
- WTSSendMessage($server, $sessionid, $title, $message[, $style [, $timeout [, \$response]]])
-
Displays a message box on the client desktop of a WTS session.
- WTSDisconnectSession($server, $sessionid [, $wait])
-
Disconnects the logged on user from the specified WTS session without closing the session.
- WTSLogoffSession($server, $sessionid [, $wait])
-
Logs off the specified WTS session.
- WTSShutdownSystem($server[, $flag])
-
Shuts down the specified WTS server. Avoid this call. I believe it doesn't behave as expected. It ignores the $server parameter and shuts down the local machine. Is this a bug or a feature? I don't know.
- WTSWaitSystemEvent($server[, $flag])
-
Waits for a WTS event before returning to the caller.
WTS EXAMPLES:
- WTSEnumerateServers($domain, \@sessions)
-
Enumerates all WTS server in domain testdomain.
if(!Win32::Lanman::WTSEnumerateServers("testdomain", \@servers)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $server(@servers) { print "${$server}{name}\n"; } - WTSOpenServer($server, \$handle)
-
Opens and closes a WTS handle on server \\testserver. These calls are not really necessary. See the description above.
if(!Win32::Lanman::WTSOpenServer("\\\\testserver", \$handle)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } # use the handle # ... if(!Win32::Lanman::WTSCloseServer($handle)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - WTSCloseServer($handle)
-
Opens and closes a WTS handle on server \\testserver. These calls are not really necessary. See the description above.
if(!Win32::Lanman::WTSOpenServer("\\\\testserver", \$handle)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } # use the handle # ... if(!Win32::Lanman::WTSCloseServer($handle)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - WTSEnumerateSessions($server, \@sessions)
-
Enumerates all sessions on the WTS server \\testserver.
if(!Win32::Lanman::WTSEnumerateSessions("\\\\testserver", \@sessions)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $session (@sessions) { foreach $key (keys %$session) { print "$key=${$session}{$key}\n"; } } - WTSEnumerateProcesses($server, \@processes)
-
Enumerates all processes on the WTS server \\testserver.
if(!Win32::Lanman::WTSEnumerateProcesses("\\\\testserver", \@processes)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $process (@processes) { foreach $key (keys %$process) { if($key eq "sid") { print "$key=", unpack("H" . 2 * length(${$process}{$key}), ${$process}{$key}), "\n"; } else { print "$key=${$process}{$key}\n"; } } } - WTSTerminateProcess($server, $processid [, $exitcode])
-
Terminates all processes which belongs to disconnected sessions on the WTS server \\testserver (these have windowstation parameter of the empty string). All processes terminate with the exit value 3 (if you omit the exitcode, the processes terminate with exit code 0). You'll get some access denied errors (error 5) because you cannot terminate system processes like csrss or winlogon.
if(!Win32::Lanman::WTSEnumerateSessions("\\\\testserver", \@sessions)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } if(!Win32::Lanman::WTSEnumerateProcesses("\\\\testserver", \@processes)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $session (@sessions) { next if ${$session}{winstationname} ne ""; foreach $process (@processes) { next unless ${$process}{sessionid} == ${$session}{id}; print "${$process}{name} (${$process}{processid}) will be terminated\n"; if(!Win32::Lanman::WTSTerminateProcess("\\\\testserver", ${$process}{processid}, 3)) { print "Oops, cannot terminate process ${$process}{processid}; error: "; # get the error code print Win32::Lanman::GetLastError(); print "\n"; } } } - WTSQuerySessionInformation($server, $sessionid, \@infoclass, \%info)
-
Returns all information available for the session id 0 (session 0 is the WTS console) on server \\testserver.
if(!Win32::Lanman::WTSQuerySessionInformation("\\\\testserver", 0, [WTSInfoClassAll()], \%info)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key (sort keys %info) { print "$key=$info{$key}\n"; } - WTSQueryUserConfig($server, $user, \@infoclass, \%config)
-
Returns all WTS specific user properties for user testuser from server \\testserver. \\testserver should be your primary domain controller.
if(!Win32::Lanman::WTSQueryUserConfig("\\\\testserver", "testuser", [WTSUserConfigAll()], \%user)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } foreach $key (sort keys %user) { print "$key=$user{$key}\n"; } - WTSSetUserConfig($server, $user, \%config)
-
Set WTS specific user properties for user testuser from server \\testserver. \\testserver should be your primary domain controller. In this sample the WTS profile path will be set to \\testserver\testpath\profile and the working directory to c:\work\testuser.
$user{terminalserverprofilepath} = "\\\\testserver\\testpath\\profile"; $user{workingdirectory} = "c:\\work\\testuser"; if(!Win32::Lanman::WTSSetUserConfig("\\\\testserver", "testuser", \%user)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - WTSSendMessage($server, $sessionid, $title, $message[, $style [, $timeout [, \$response]]])
-
Displays a message box with the text "a message to the console" and the caption "hi console user" on the console desktop (session id 0) on the WTS \\testserver. The message box disappears after 15 seconds or if the user presses the Ok button. You can specify a style or 0 for the default (simply an Ok button). The available style values you'll find in the MessageBox description in the platform sdk. If you pass a response value, the call returns which button the user pressed or if the timeout elapsed. If you omit the timeout value or the timeout is null, the function returns immediately. Otherwise it returns if the user pressed a button on the message box or if the timeout elapsed.
if(!Win32::Lanman::WTSSendMessage("\\\\testserver", 0, "a message to the console", "hi console user", 0, 15, \$response)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } print $response; - WTSDisconnectSession($server, $sessionid [, $wait])
-
Disconnects the user logged on the desktop window station (session id 0) on server \\testserver. The session is closed only. The user won't be logged off. The calling process waits til the connection is closed ($wait == 1).
if(!Win32::Lanman::WTSDisconnectSession("\\\\testserver", 0, 1)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - WTSLogoffSession($server, $sessionid [, $wait])
-
Logs off the user logged on the desktop window station (session id 0) on server \\testserver. The calling process waits until the user is logged off ($wait == 1).
if(!Win32::Lanman::WTSDisconnectSession("\\\\testserver", 0, 1)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; } - WTSShutdownSystem($server[, $flag])
-
Avoid using this call. It's buggy. See the notes above.
- WTSWaitSystemEvent($server[, $flag])
-
Waits for the WTS event WTS_EVENT_LOGON (a user logs on) on server \\testserver and returns as soon as the event occurs. You'll find the available events in the constants section above (WTS_EVENT_*). You can specify more than one event type by or'ing them. The $event returns which event occured.
if(!Win32::Lanman::WTSWaitSystemEvent("\\\\testserver", &WTS_EVENT_LOGON | &WTS_EVENT_LOGOFF, \$event)) { print "Sorry, something went wrong; error: "; # get the error code print Win32::Lanman::GetLastError(); exit 1; }
AUTHOR
Jens Helberg <jens.helberg@de.bosch.com>
You can use this module under GNU public licence.
3 POD Errors
The following errors were encountered while parsing the POD:
- Around line 2327:
You can't have =items (as at line 2333) unless the first thing after the =over is an =item
- Around line 5902:
You can't have =items (as at line 5911) unless the first thing after the =over is an =item
- Around line 6709:
You can't have =items (as at line 6714) unless the first thing after the =over is an =item