The Win32 Network Management APIs 7

 

 

 

 

 

Schedule Functions

 

The network management schedule service functions submit and manage jobs that execute on a specified computer at a particular time (or times) in the future. Jobs can include commands and programs. The functions manage jobs at remote and local computers, provided the schedule service is running on the computer. The schedule service functions are listed following.

 

Function

Description

NetScheduleJobAdd()

Submits a job to run at a specified future date and time.

NetScheduleJobDel()

Cancels a range of jobs queued to run on a computer.

NetScheduleJobEnum()

Lists the jobs queued on a specified computer.

NetScheduleJobGetInfo()

Returns information about a particular job queued on a computer.

GetNetScheduleAccountInformation()

Retrieves the AT Service account name.

SetNetScheduleAccountInformation()

Sets the AT Service account name and password.

 

For the network management schedule functions to succeed, a caller must have administrator's privilege at the computer where the schedule service is running. The schedule service functions are also known as "Job" and "AT command" functions. The AT_INFO structure is used by the NetScheduleJobAdd function to specify information when submitting a job, and by the NetScheduleJobGetInfo() function to retrieve information about a job that has been submitted. The AT_ENUM structure is used by NetScheduleJobEnum() to enumerate and return information about an entire queue of submitted jobs.

 

Server Functions

 

The network management server functions perform administrative tasks on a local or remote server. The server functions are listed following.

 

Function

Description

NetServerDiskEnum()

Returns a list of local disk drives on a server.

NetServerEnum()

Lists all visible servers of a particular type (or types) in the specified domain.

NetServerGetInfo()

Returns configuration information about a specified server.

NetServerSetInfo()

Sets the operating parameters for a server.

 

Only a user or application with admin group membership on a local or remote server can perform administrative tasks on that server to control the server's operation, user access, and resource sharing. The low-level parameters that affect a server's operation can be examined and modified by calling the NetServerGetInfo() and NetServerSetInfo() functions. These parameters are defined in the server's LANMAN.INI file. Most network management server functions execute only on a remote server. The NetServerEnum() function executes on either a local workstation or a remote server. If you attempt to execute other server functions on a local workstation, the functions return the error NERR_RemoteOnly. Server-specific information is available at the following levels:

 

  1. SERVER_INFO_100
  2. SERVER_INFO_101
  3. SERVER_INFO_102
  4. SERVER_INFO_402
  5. SERVER_INFO_403
  6. SERVER_INFO_1501
  7. SERVER_INFO_1502
  8. SERVER_INFO_1503
  9. SERVER_INFO_1506
  10. SERVER_INFO_1509
  11. SERVER_INFO_1510
  12. SERVER_INFO_1511
  13. SERVER_INFO_1512
  14. SERVER_INFO_1513
  15. SERVER_INFO_1515
  16. SERVER_INFO_1516
  17. SERVER_INFO_1518
  18. SERVER_INFO_1523
  19. SERVER_INFO_1528
  20. SERVER_INFO_1529
  21. SERVER_INFO_1530
  22. SERVER_INFO_1533
  23. SERVER_INFO_1536
  24. SERVER_INFO_1538
  25. SERVER_INFO_1539
  26. SERVER_INFO_1540
  27. SERVER_INFO_1541
  28. SERVER_INFO_1542
  29. SERVER_INFO_1544
  30. SERVER_INFO_1550
  31. SERVER_INFO_1552

 

If you are programming for Active Directory, you may be able to call certain Active Directory Service Interface (ADSI) methods to achieve the same functionality you can achieve by calling the network management server functions..

 

Server and Workstation Transport Functions

 

The network management server and workstation transport functions handle binding and unbinding of transport protocols to and from the server and redirector. The server transport functions deal with transport protocols managed by the server; the workstation transport functions deal with transport protocols managed by the redirector. File sharing between a transport device and a server has two components:

 

  1. The server computer where the files reside
  2. A Server Message Block (SMB) client that accesses the files

 

The client computer communicates with the server computer over a local area network using a transport protocol; for example, TCP or XNS. The client sends requests to the server to retrieve data. The software on the client computer that generates the file requests is called the redirector because it redirects local file requests to the server computer. The software on the computer that receives and acts on the file requests is called the server because it serves the clients. The format specific to these requests is called the SMB protocol. The server transport functions are listed following.

 

Function

Description

NetServerComputerNameAdd()

Binds an emulated server name to each of the transport protocols on which a server is active. (Combines the functionality of the NetServerTransportEnum() function and the NetServerTransportAddEx() function.)

NetServerComputerNameDel()

Disconnects each network transport protocol from an emulated server name set by a previous call to the NetServerComputerNameAdd() function.

NetServerTransportAdd()

Binds the specified server to the transport protocol. (This function supports only the SERVER_TRANSPORT_INFO_0 information level.)

NetServerTransportAddEx()

Binds the specified server to the transport protocol. (This extended function supports the SERVER_TRANSPORT_INFO_1, SERVER_TRANSPORT_INFO_2, and SERVER_TRANSPORT_INFO_3 information levels.)

NetServerTransportDel()

Disconnects the transport protocol from the server.

NetServerTransportEnum()

Enumerates the transport protocols managed by the server.

 

Server transport functions are available at the following information levels:

 

  1. SERVER_TRANSPORT_INFO_0
  2. SERVER_TRANSPORT_INFO_1
  3. SERVER_TRANSPORT_INFO_2
  4. SERVER_TRANSPORT_INFO_3

 

The workstation transport functions perform equivalent operations for the workstation. Windows Server 2003 and Windows XP/2000:  The redirector does not support the NetWkstaTransportAdd() function or the NetWkstaTransportDel() function. You can change the default settings for transport protocols manually through the Local Area Connection Properties dialog box in the Network and Dial-Up Connections folder. The workstation transport functions are listed following.

 

Function

Description

NetWkstaTransportAdd()

Connects the redirector to the transport protocol.

NetWkstaTransportDel()

Disconnects the transport protocol from the redirector.

NetWkstaTransportEnum()

Lists the transport protocols that are managed by the redirector.

 

Workstation transport functions are available at one information level: WKSTA_TRANSPORT_INFO_0

 

 

 

 

< Win32 Network Management APIs 6 | Win32 Network Management APIs | Win32 Programming | Win32 Network Management APIs 8 >