PrlVmCfg_GetLinkedVmUuid Function

Returns the UUID (universally unique ID) of the parent virtual machine which was used to create current linked cloned virtual machine (if last one is linked clone of some virtual machine - this value will be empty otherwise).

Syntax

PRL_RESULT PrlVmCfg_GetLinkedVmUuid(
    PRL_HANDLE hVmCfg, 
    PRL_STR sVmUuid, 
    PRL_UINT32_PTR pnVmUuidBufLength
);

File

PrlApiVm.h

Parameters

hVmCfg

A handle of type PHT_VM_CONFIGURATION identifying the virtual machine configuration.

sVmUuid

[out] A pointer to a buffer that receives the result (a UTF-8 encoded, null-terminated string).

pnVmUuidBufLength

[in] The size of the output buffer (in bytes). Set the buffer pointer to null and this parameter's value to zero to receive the required size. [out] The required output buffer size.

Returns

PRL_RESULT. Possible values are:

PRL_ERR_INVALID_ARG - invalid handle or null pointer was passed.

PRL_ERR_BUFFER_OVERRUN - the size of the output buffer is not large enough. The parameter that is used to specify the size will contain the required size.

PRL_ERR_SUCCESS - function completed successfully.

Links

PHT_VM_CONFIGURATION