www.vmware.com
28
C API Reference Guide
RC1
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.
Example
The following example prints the path name of every virtual machine currently
running on the host.
static VixHandle hostHandle = VIX_INVALID_HANDLE;
void VixDiscoveryProc(VixHandle jobHandle,
VixEventType eventType,
VixHandle moreEventInfo,
void *clientData)
{
VixError err = VIX_OK;
VixHandle jobHandle = VIX_INVALID_HANDLE;
VixHandle vmHandle = VIX_INVALID_HANDLE;
char *url = NULL;
// Check callback event; ignore progress reports.
if (VIX_EVENTTYPE_FIND_ITEM != eventType) {
return;
}
// Found a virtual machine.
err = Vix_GetProperties(moreEventInfo,
VIX_PROPERTY_FOUND_ITEM_LOCATION,
&url,
VIX_PROPERTY_NONE);
if (VIX_OK != err) {
// Handle the error...
goto abort;
}
printf("\nFound virtual machine: %s", url);
return;
abort:
Vix_ReleaseHandle(jobHandle);
Vix_FreeBuffer(url);
}
int main()
{
VixHandle jobHandle = VIX_INVALID_HANDLE;
