Name

Description

HRESULT
FindItems([in] LONG searchType,
          [in] IVixHandle* searchCriteria,
          [in] LONG timeout,
          [in] ICallback* jobDoneCallback,
          [out,retval] IJob** findJob);

This method asynchronously finds Vix objects and calls the application's ICallback object's OnVixEvent method to report each object found. For example, when used to find all running virtual machines, FindItems() returns a series of virtual machine file path names.

Parameters

searchType

The type of items to find. Values are listed in the Types Reference under VixFindItemType.

searchCriteria

Must be NULL (C++), null (C#), Nothing (VB).

timeout

Must be -1.

jobDoneCallback

An ICallback instance that will be called when the operation is complete.

findJob

Returns an IJob object that describes the state of this asynchronous operation.

Return Value

Remarks

• When an object is found, VixHost_FindItems() passes the value Vix_EVENTTYPE_FIND_ITEM in the eventType parameter.

• When an object is found, VixHost_FindItems() passes a property list object containing the location of the object found. The property list is passed as the value of the moreEventInfo parameter. The property list contains a single string value (Vix_PROPERTY_FOUND_ITEM_LOCATION), which is the URL of the item found.

• When VixHost_FindItems() is done searching, it calls the callback function a final time and passes Vix_EVENTTYPE_CALLBACK_SIGNALLED as the event type.

Side Effects

Requirements

Example

class Program
{

   static void main(string args[])  
   {
      VixCOM.VixLibClass lib = new VixCOM.VixLibClass();
      UInt64 err;
      object results = null;
      
      VixCOM.IJob job = lib.Connect(VixCOM.Constants.VIX_API_VERSION,
                                    VixCOM.Constants.VIX_SERVICEPROVIDER_VMWARE_WORKSTATION,
                                    null,
                                    0,
                                    null,
                                    null,
                                    0,
                                    null,
                                    null);
     err = job.Wait(new int[] {VixCOM.Constants.VIX_PROPERTY_JOB_RESULT_HANDLE} , results);
     if (lib.ErrorIndicatesFailure(err)) {
        // Handle the error... 
     }
     
     VixCOM.IHost host =((object[])results)[0];
     
     job = host.FindItems(VixCOM.Constants.VIX_FIND_RUNNING_VMS,
                          null,
                          -1,
                          new DiscoveryCallback(lib));
     job.WaitWithoutResults();
     
     host.Disconnect();
   }
   
   class DiscoveryCallback : VixCOM.ICallback {
      
      protected VixCOM.VixLibClass lib;
      
      public DiscoveryCallback(VixCOM.VixLib lib)
      {
         this.lib = lib;
      }
      
      void OnVixEvent(VixCOM.IJob job,
                      int eventType,
                      VixCOM.IVixHandle moreEventInfo)
      {
         UInt64 err;
         
         // Ignore progress reports.
         if (eventType != VixCOM.Constants.VIX_EVENTTYPE_FIND_ITEM) {
            return;
         }
         
         object results = null;
         
         err = moreEventInfo.GetProperties(new object[] { VixCOM.Constants.VIX_PROPERTY_FOUND_ITEM_LOCATION },
                                           ref results);
         if (lib.ErrorIndicatesFailure(err)) {
            // Handle the error...
         }
         string vmPathName = (string)((object[])results)[0];
      } 
   }
}