PrlFoundVmInfo_GetConfigPath Function

Extracts the virtual machine configuration path from the container.

Syntax

PRL_RESULT PrlFoundVmInfo_GetConfigPath(
    PRL_HANDLE handle, 
    PRL_STR sPath, 
    PRL_UINT32_PTR pnPathBufLength
);

File

PrlApi.h

Parameters

handle

A handle of type PHT_FOUND_VM_INFO identifying the container.

sPath

[out] A pointer to a buffer that receives the path. Pass a null pointer to determine the required buffer size.

pnPathBufLength

[in] The size of the buffer used to receive the output data (in bytes). [out] The required buffer size if the buffer parameter contains a null pointer or if the specified buffer size is not large enough.

Returns

PRL_RESULT. Possible values are:

PRL_ERR_INVALID_ARG - invalid handle.

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

PRL_ERR_SUCCESS - function completed successfully.

Links

PrlApi.h, PHT_FOUND_VM_INFO