IProvQueue::SubmitRequest

Submits a simple request to the Provisioning Queue Manager Service of Microsoft Provisioning Framework (MPF).

SubmitRequest includes an option to submit a suspended request. SubmitRequest is the standard method to submit untrusted requests to queue managers for both COM and HTTP/SOAP applications.

Arguments

Remarks

Queued requests can be submitted as either activated or suspended. An activated request is always executed regardless of whether the corresponding MPF transaction succeeds or fails. A suspended request is automatically activated if the transaction succeeds; otherwise the transaction fails and is deleted. It is not possible to suspend an active request.

Performance Counters

Counter Object: Microsoft Provisioning Client

Counter Instance: Queued Requests

Average Request Latency	Average time for this client to execute a provisioning request. Each call to SubmitRequest contributes to the average latency of up to the last 100 requests.
Request Rate	Incoming request rate for this client. Each call to SubmitRequest contributes to the average request rate of transactions per second.
Requests Executing	Number of concurrently executing requests at this client. Identifies the total number of concurrent calls to SubmitRequest.
Total Requests	Number of requests this client has processed. Each call to SubmitRequest increments this counter.
Total Requests Failed	Total number of failed requests that this client initiated. Each call to SubmitRequest that returns a failed HRESULT increments this counter.

C++ Syntax

HRESULT SubmitRequest  (
	BSTR bstrRequest,
	BSTR bstrNamespace,
	BSTR bstrProcedure,
	BOOL fSuspended,
	BSTR *bstrQueueID
);

Sample Code

Typical C++ Usage

LPCWSTR wszRequest = L"<request>\n" + 
					 L"  <data>\n" +
					 L"	<organizations>\n" +
					 L"	<organization name=\"tailspintoys.com\"/>\n" +
					 L"	</organizations>\n" +
					 L"  </data>\n" +
					 L"  <context>\n" +
					 L"	<clientContext clientTransactionId=\"53367B03-63D3-44ae-B8AD-C1E57E876E6C\"/>\n" +
					 L"  </context>\n" +
					 L"</request>";

IProvQueue * pProvQueue = NULL;
BSTR bstrRequest = ::SysAllocString(wszRequest);
BSTR bstrNamespace = ::SysAllocString(L"Test Namespace");
BSTR bstrProcedure = ::SysAllocString(L"Write Request");
BSTR bstrQueueID = NULL;
HRESULT hr = E_OUTOFMEMORY;

if(bstrRequest && bstrNamespace && bstrProcedure)
{
	// Create queue manager client:
	hr = CoCreateInstance(CLSID_ProvQueueClient, NULL, CLSCTX_ALL, IID_IProvQueue, (void**)(&pProvQueue));
	if(hr == S_OK)
	{
		hr = pProvQueue->SubmitRequest(bstrRequest, bstrNamespace, bstrProcedure, FALSE, &bstrQueueID);
		pProvQueue->Release();
}
}

// Get the error description in the case of error
if(FAILED(hr))
{
	IErrorInfo* pErrInfo = NULL;
	if(::GetErrorInfo(0, &pErrInfo) == S_OK && pErrInfo)
	{
		pErrInfo->GetDescription(&bstrQueueID);
		pErrInfo->Release();
}
}

// Show the results
MessageBoxW(NULL, bstrQueueID ? bstrQueueID : L"Unknown error occured", L"Queued request results", MB_OK);

// Clean up
::SysFreeString(bstrRequest);
::SysFreeString(bstrNamespace);
::SysFreeString(bstrProcedure);
::SysFreeString(bstrQueueID);

Applies To