PrlApi_SignCertificate Function

Sign user certificate on manager CA .

Syntax

PRL_HANDLE PrlApi_SignCertificate(
    PRL_CONST_STR account, 
    PRL_CONST_STR accountPass, 
    PRL_CONST_STR hostUuid, 
    PRL_PROXY_CLIENT_INFO_PTR cliInfo, 
    PRL_CONST_STR signingRequest, 
    PRL_UINT32 timeout, 
    PRL_EVENT_HANDLER_PTR handler, 
    PRL_VOID_PTR userData, 
    PRL_UINT32 flags
);

File

PrlApiManager.h

Parameters

account

Parallels account.

accountPass

Parallels account password. hostUuid Parallels host UUID.

cliInfo

Additional client information. signingRequest Certifiate signing request.

timeout

Timeout in milliseconds. The authenticate operation will stop once this limit is reached.

handler

Optional. A pointer to a user callback function (event handler) that will be called when operation become complete.

userData

Optional. A pointer to a user data that will be passed to the optional callback function. flags Optional. Reserved for future needs.

Returns

A handle of type PHT_JOB containing the results of this asynchronous operation or PRL_INVALID_HANDLE if there's not enough memory to instantiate the job object.

To get the results from the PHT_JOB object:

Use the PrlJob_GetResult function to obtain a handle to the PHT_RESULT object.
Use the PrlResult_GetParamByIndexAsString function to obtain a string containing user signed certificate from first param.

See Also PrlSrv_CreateCredentials.....................

Remarks

PRL_ERR_INVALID_ARG - null pointer was passed.

Links

System Functions