wstring NagRdu::CreateAndDownloadDumpAsync ( wstring szwProcessName )

Asynchronously creates and downloads a dump for a specific process.

Parameters:

szwProcessName short process name, for example, 'klnagent.exe'.

Returns:: ID of an asynchronous request. Use this ID to get the result with a URL path for the subsequent dump download.

Remarks:: To check the state of the dump creation and download procedure, call AsyncActionStateChecker::CheckActionState periodically until the procedure is completed. If the operation succeeds, AsyncActionStateChecker::CheckActionState returns a URL path in pStateData. Otherwise, the AsyncActionStateChecker::CheckActionState call returns an error in pStateData.

Call:

                        strRequestId = DownloadCommonDataAsync;
                        pResParams = CheckActionState(strRequestId);
                        strResFilename = pResParams.Get("LastActionResult");
                        strResUrl = GetUrlToDownloadFileFromHost(strResFilename);

Download the file content using strResUrl.

Exceptions:

The	function throws an exception in case of an error.