# Name

VixDiskLib_Create

# Description

    VixError
    VixDiskLib_Create(const VixDiskLibConnection connection,
                      const char *path,
                      const VixDiskLibCreateParams *createParams,
                      VixDiskLibProgressFunc progressFunc,
                      void *progressCallbackData);

This function creates a virtual disk as specified in createParams.

# Parameters

connection
  A valid VixDiskLib connection created to manipulate hosted disks. See VixDiskLib_Connect() for instructions on how to create such a connection.
path
  Path name for the newly created Virtual Disk file.
createParams
  Specification for the new Virtual Disk.
progressFunc
  A pointer to a function of type VixDiskLibProgressFunc. VixDiskLib will call this function periodically to update progress.
progressCallbackData
  Opaque data that VixDiskLib will pass to progressFunc.

# Return Value

VIX_OK if the function succeeded, otherwise an appropriate VIX error code.

# Remarks

- VixDiskLib_Create() can or create managed disks on a datastore location. To create such a disk, first create a hosted type disk and use VixDiskLib_Clone() to convert the virtual disk to a managed disk.

# Example

       VixError vixError = VixDiskLib_Create(appGlobals.connection,
                                             appGlobals.diskPath,
                                             &createParams,
                                             NULL,
                                             NULL);

Copyright (C) 2007-2012 VMware, Inc. All rights reserved.