Hello World

This provider can be used to build a very basic provider, register it with the system, and have it return some data to the caller.

Visual Studio 2003

To register the Hello World Provider Sample in Visual Studio 2003

In Visual Studio 2003, from the File menu, point to Open, then click to select Project.
Navigate to the folder where the sample providers are installed, which by default should be: <local root directory>:Program Files\Microsoft Hosting\Development\Samples\CSharp\1.1\HelloWorld
Open the HelloWorldProvider.csproj file.
Once open, build the project by pressing CTRL-SHIFT-B.
Navigate to the project's \\bin\debug folder and view the namespace file that has been generated (in the format of: HelloWorld_ns.xml).

You can open up Provisioning Manager and import this namespace, or go to a command prompt, navigate to <SystemDrive> :Program Files\Microsoft Hosting\Development\Samples\CSharp\1.1\HelloWorld, and then use the 'provnamespace' command to register the namespace with Microsoft Provisioning System (MPS) with the following command: Provnamespace HelloWorld_ns.xml

Now a request can be submitted from the command line in order to test the provider. Create a sample request, similar to the following:

<request>
  <data />
  <procedure>
	<execute namespace="SDK Hello World Provider" procedure="Hello World">
	<after source="executeData" destination="data" mode="merge" />
	</execute>
  </procedure>
</request>

Submit the request to MPS, and the response from MPS should be:
<response>
  <data>
	<say>Hello World!</say>
  </data>
</response>

Submit the request to MPS, and the response from MPS should be:

<response>
  <data>
	<say>Hello World!</say>
  </data>
</response>

Visual Studio 2005

You can follow the same steps as those provided in Visual Studio 2003 to register this sample provider. Or, you can use the MPS SDK Visual Studio add-ins to register providers from the Solution Explorer instead.

To register the Hello World Provider Sample in Visual Studio 2005 using MPS SDK add-in features

In Visual Studio 2005, from the File menu, point to Open, then click to select Project.
Navigate to the folder where the sample providers are installed, which by default should be: <SystemDrive>:Program Files\Microsoft Hosting\Development\Samples\CSharp\1.1\HelloWorld
In the project's Solution Explorer, click Show All Files. The project should show a bin/debug folder.
Within the debug folder, double-click the namespace file.
Right-click the file in the main window, and then click Register Namespace.

The MPS Output window will indicate that the namespace was registered successfully. A new namespace beginning with the letters "SDK" will now show up in the Provisioning Manager, and refreshing the Namespace Browser window in Visual Studio should yield the same result.

You can send a sample request using the method described in Visual Studio 2003 or you can create one by right-clicking the procedure and then clicking Create Sample Request. If there are any inputs to modify, change them, and then save the file.

The sample request will be similar to the following example:

<request>
  <data />
  <procedure>
	<execute namespace="SDK Hello World Provider" procedure="Hello World">
	<after source="executeData" destination="data" mode="merge" />
	</execute>
  </procedure>
</request>

Submit the request to MPS, and the response from MPS should be:
<response>
  <data>
	<say>Hello World!</say>
  </data>
</response>

Submit the request to MPS. The response from MPS should be:

<response>
  <data>
	<say>Hello World!</say>
  </data>
</response>

A test can also be run from within Visual Studio 2005 by opening the MPS Development Tools.

To test the Hello Word Sample Provider within Visual Studio 2005

In the MPS Namespace Explorer window, navigate to the SDK Hello World Provider CS provider.
Click the HelloWorld Method nested below this provider.
In the MPS Procedure Browser window, right-click the Provider call (SDK Hello World Provider CS::HelloWorld), and then select Execute. The output window will appear, and will show the request and the response of the MPS call.

VB.NET

To register the Hello World Provider Sample in Visual Studio 2005

In Visual Studio 2005, from the File menu, point to Open, then click Project.
Navigate to the folder where the sample providers are installed, which by default should be: <SystemDrive> :Program Files\Microsoft Hosting\Development\Samples\VBNet\2.0\HelloWorld
Open the HelloWorldProviderVB.vbproj file.
Once open, build the project by pressing CTRL+SHIFT+B.
Navigate to the project's \\bin\debug folder and view the namespace file that has been generated (in the format of: HelloWorldProviderVB_ns.xml).

You can open up Provisioning Manager and import this namespace, or go to a command prompt, navigate to <SystemDrive> :Program Files\Microsoft Hosting\Development\Samples\VBNet\2.0\HelloWorld, and then use the provnamespace command to register the namespace with MPS with the following command: Provnamespace HelloWorldVB_ns.xml

To register the Hello World Provider Sample in Visual Studio 2005 using MPS SDK add-in features

In Visual Studio 2005, on the File menu, point to Open, and then click Project.
Navigate to the folder where the sample providers are installed, which by default should be: <local root directory>:Program Files\Microsoft Hosting\Development\Samples\VBNet\2.0\HelloWorld
In the project's Solution Explorer, click Show All Files. The project should show a bin/debug folder.
Within the debug folder, double-click the namespace file.
Right-click the file in the main window, and then click Register Namespace.

The MPS Output window should indicate that the namespace was registered successfully. A new namespace beginning with the letters "SDK" should now show up in the Provisioning Manager, and refreshing the Namespace Browser window in Visual Studio should yield the same result.

Now a request can be submitted from the command line in order to test the provider. Create a sample request, similar to the following:

<request>
  <data />
  <procedure>
	<execute namespace="SDK Hello World Provider" procedure="Hello World">
	<after source="executeData" destination="data" mode="merge" />
	</execute>
  </procedure>
</request>

Submit the request to MPS, and the response from MPS should be:
<response>
  <data>
	<say>Hello World!</say>
  </data>
</response>

Submit the request to MPS. The response from MPS should be:

<response>
  <data>
	<say>Hello World!</say>
  </data>
</response>

A test can also be run from within Visual Studio 2005 by opening the MPS Development Tools.

To test the Hello Word Sample Provider within Visual Studio 2005

In the MPS Namespace Explorer window, navigate to the SDK Hello World Provider VB provider.
Click the HelloWorld Method nested below this provider.
In the MPS Procedure Browser window, right-click the Provider call (SDK Hello World Provider VB::HelloWorld), and then select Execute. The output window will appear, and will show the request and the response of the MPS call.