PrlApi_SendProblemReport Function

The PrlApi_SendProblemReport lets to send previously extracted with PrlSrv_GetProblemReport or PrlVm_GetProblemReport calls problem report to the Virtuozzo support server.

Syntax

PRL_HANDLE PrlApi_SendProblemReport(
    PRL_CONST_STR sProblemReport, 
    PRL_BOOL bUseProxy, 
    PRL_CONST_STR sProxyHost, 
    PRL_UINT32 nProxyPort, 
    PRL_CONST_STR sProxyUserLogin, 
    PRL_CONST_STR sProxyUserPasswd, 
    PRL_UINT32 nProblemSendTimeout, 
    PRL_UINT32 nReserved, 
    PRL_EVENT_HANDLER_PTR handler, 
    PRL_VOID_PTR pUserData
);

File

PrlApiCore.h

Parameters

sProblemReport

problem report string representation (expected null terminated string in UTF-8 encoding)

bUseProxy

sign specifies whether proxy settings should be used. Either system proxy settings can be automatically by API call retrieved and used or custom settings can be specified by follow params (note that custom values override correspond system settings)

sProxyHost

[optional] if using proxy this param lets to specify proxy server host address/name (can be null or empty)

nProxyPort

[optional] if using proxy this param lets to specify proxy server port (should be 0 in order to specify to use system settings)

sProxyUserLogin

[optional] if using proxy this param lets to specify user login if last one not specified at system proxy settings or need to be overridden (can be null or empty)

sProxyUserPasswd

[optional] if using proxy this param lets to specify user password if last one not specified at system proxy settings (can be null or empty)

nProblemSendTimeout

timeout in milliseconds which specifies maximal awaiting problem report send time (0 value not limiting problem report send operation at all)

nReserved

[unused] reserved parameter for further purposes

handler

[optional] A pointer to a user callback function (event handler) that will be called every time a problem report sending progress changed or job completed.

pUserData

[optional] A pointer to a user data that will be passed to the optional callback function.

Returns

PRL_RESULT. Possible values:

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.

PRL_ERR_SUCCESS - function completed successfully.

Links

System Functions