# Name

VixDiskLib_GetTransportMode

# Description

    const char *
    VixDiskLib_GetTransportMode(VixDiskLibHandle diskHandle);

Returns a pointer to a static string identifying the transport mode that is used to access the virtual disk's data.

If a disk was opened through a connection obtained by VixDiskLib_Connect(), the return value is "file" for a hosted disk and "nbd" for a managed disk.

# Parameters

diskHandle
  Handle to an open virtual disk.

# Return Value

Returns a static string identifying the transport mode used to open the disk. Returns NULL if diskHandle is a NULL handle.

# Remarks

- A list of known transport modes is returned by VixDiskLib_ListTransportModes().
- The "file" and "nbd" modes are built into VixDiskLib so they are always recognized.
- Calling VixDiskLib_ConnectEx() instead of VixDiskLib_Connect() enables a wider range of transport modes, some of which result in better I/O performance when accessing managed disks on shared storage or when running inside a virtual machine.

# Example

       printf("Using transport mode: %s\n", VixDiskLib_GetTransportMode(diskHandle));

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