PrlApi_SignCertificateEx Function

Sign user certificate on manager CA.

Syntax

PRL_HANDLE PrlApi_SignCertificateEx(
    PRL_CONST_STR managerToken, 
    PRL_CONST_STR hostUuid, 
    const 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

managerToken

Parallels Manager token. 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

Alternative form of PrlApi_SignCertificate method with authorization via Manager's token.

PRL_ERR_INVALID_ARG - null pointer was passed.

Links

System Functions