112 lines
4.8 KiB
Plaintext
112 lines
4.8 KiB
Plaintext
========================================================================
|
|
CONSOLE APPLICATION : WdsTransportManager Project Overview
|
|
========================================================================
|
|
|
|
This sample application illustrates using the Windows Deployment Services
|
|
(WDS) Transport Management API, sometimes referred to as WdsTptMgmt, to
|
|
manage a WDS Transport Server. The API allows 3rd party applications
|
|
to manage and use the multicast features provided by a WDS Transport
|
|
Server in order to allow the download of any type of data by custom
|
|
client applications.
|
|
|
|
The files contained in this sample are described below.
|
|
|
|
WdsTransportManager.sln
|
|
This is the solution file for the WdsTransportManager sample generated
|
|
using Visual Studio. This is the solution file which should be loaded
|
|
into Visual Studio to generate the executable for this sample.
|
|
|
|
WdsTransportManager.vcxproj
|
|
This is the main project file for VC++ projects generated using an
|
|
Application Wizard. It contains information about the version of Visual C++
|
|
that generated the file, and information about the platforms,
|
|
configurations, and project features selected with the Application Wizard.
|
|
|
|
WdsTransportManager.cpp
|
|
This is the main application source file. It contains the main function
|
|
and associated helper functions that illustrate using the WdsTptMgmt
|
|
API.
|
|
|
|
WdsTransportManager.h
|
|
This is the main application header file containing type definitions,
|
|
utility macros and similar items.
|
|
|
|
Other standard files:
|
|
|
|
StdAfx.h, StdAfx.cpp
|
|
These files are used to build a precompiled header (PCH) file
|
|
named WdsTransportManager.pch and a precompiled types file named StdAfx.obj.
|
|
|
|
ReadMe.txt
|
|
This ReadMe file.
|
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
The Windows Deployment Services Transport Management API
|
|
========================================================
|
|
|
|
The WDS Transport Management API is a part of the overall WDS Transport
|
|
platform which allows any software developer to develop a complete solution
|
|
to transmit any type of data over a reliable multicast transport and have
|
|
complete control over server configuration, the data being offered for
|
|
download, and the individual transport sessions and clients.
|
|
|
|
WdsTptMgmt is designed to provide full programmatic support for the
|
|
management tasks of a local or remote WDS Transport Server. Management
|
|
features are provided over a set of COM interfaces which include:
|
|
|
|
1. Setup Management:
|
|
a. Provides information on the server, such as host OS version.
|
|
b. Allows applications to register/deregister custom content providers.
|
|
|
|
2. Configuration Management:
|
|
a. Allows applications to control the WDS Transport services, such as
|
|
enabling, disabling, or starting the services.
|
|
b. Allows applications to configure various transport settings, such
|
|
as IP address ranges, port ranges, and diagnostic settings.
|
|
|
|
3. Namespace Management:
|
|
a. Allows applications to add or remove a registered transport namespace
|
|
or query information on registered namespaces. Transport namespaces
|
|
define what content is being offered for download, what content provider
|
|
is responsible for preparing the data for transmission, and transmission
|
|
start parameters, such as an absolute time at which transmission would
|
|
begin.
|
|
b. Allows applications to query and manage active sessions and clients
|
|
under a given namespace, including support for terminating a session
|
|
or disconnecting a particular client.
|
|
|
|
For more information, please refer to the Windows SDK documentation.
|
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
Sample Program Usage
|
|
====================
|
|
This sample demonstrates using WdsTptMgmt to enable/disable WDS transport
|
|
services and add/remove a transport namespace.
|
|
|
|
To run the sample, simply follow the usage instructions below.
|
|
|
|
WdsTptMgr.exe <WDS Server> <Action> [ <Namespace Name> <Folder Path>
|
|
<Minimum Clients> ]
|
|
|
|
where:
|
|
|
|
<WDS Server>: Name of a WDS Transport Server
|
|
<Action>: One of the values EnableServer, DisableServer,
|
|
AddNamespace, RemoveNamespace
|
|
<Namespace Name>: The name of the namespace to add/remove.
|
|
<Folder Path>: Full path to the folder to be offered for
|
|
download in a namespace that is being added.
|
|
<Minimum Clients>: The minimum number of clients to auto-start
|
|
a namespace that is being added.
|
|
|
|
At the end of execution, WdsTptMgr.exe will print a final result that
|
|
either indicates success or failure (accompanied by an HRESULT error code).
|
|
|
|
NOTE:
|
|
The user running the application has to be an administrator on the
|
|
server specified in the <WDS Server> argument.
|
|
|
|
/////////////////////////////////////////////////////////////////////////////
|