Changeset 2672 in vbox for trunk/include/VBox/com/com.h

Timestamp:

May 16, 2007 3:31:49 PM (18 years ago)

Author:

vboxsync

Message:

Main: Ported latest dmik/exp branch changes (r21219:21226) into the trunk.

File:

• trunk/include/VBox/com/com.h (modified) (1 diff)

trunk/include/VBox/com/com.h

@@ -38 +38 @@
 
 /**
- *  Shutdowns the COM runtime.
+ *  Shuts down the COM runtime.
  *  Must be called on every thread before termination.
- *  No any COM calls may be made after this method returns.
+ *  No COM calls may be made after this method returns.
  */
 void Shutdown();
+
+/**
+ *  Resolves a given interface ID to a string containing the interface name.
+ *  If, for some reason, the given IID cannot be resolved to a name, a NULL
+ *  string is returned. A non-NULL string returned by this funciton must be
+ *  freed using SysFreeString().
+ *
+ *  @param aIID     ID of the interface to get a name for
+ *  @param aName    Resolved interface name or @c NULL on error
+ */
+void GetInterfaceNameByIID (const GUID &aIID, BSTR *aName);
 
 }; // namespace com