Changeset 27685 in vbox for trunk/src/VBox/Main

Timestamp:

Mar 24, 2010 7:27:23 PM (15 years ago)

Author:

vboxsync

Message:

Main/Machine: add stub for method to read VM log file.

Location:

trunk/src/VBox/Main

Files:

• MachineImpl.cpp (modified) (1 diff)
• idl/VirtualBox.xidl (modified) (2 diffs)
• include/MachineImpl.h (modified) (1 diff)

trunk/src/VBox/Main/MachineImpl.cpp

@@ -4714 +4714 @@
 }
 
+STDMETHODIMP Machine::ReadLog(ULONG /*aIdx*/, ULONG64 /*aOffset*/, ULONG64 /*aSize*/, ComSafeArrayOut(BYTE, aData))
+{
+    CheckComArgExpr(aData, !ComSafeArrayOutIsNull(aData));
+
+    ReturnComNotImplemented();
+}
+
+
 // public methods for internal purposes
 /////////////////////////////////////////////////////////////////////////////

trunk/src/VBox/Main/idl/VirtualBox.xidl

@@ -4270 +4270 @@
   <interface
      name="IMachine" extends="$unknown"
-     uuid="254f7fd0-a99b-4ea9-992f-794624e67882"
+     uuid="07862b34-c068-4667-be7d-1d722f496f20"
      wsmap="managed"
      >
@@ -6132 +6132 @@
       </param>
     </method>
-</interface>
+
+    <method name="readLog">
+      <desc>
+        Reads the VM log file. The chunk size is limited, so even if you
+        ask for a big piece there might be less data returned.
+      </desc>
+      <param name="idx" type="unsigned long" dir="in">
+        <desc>
+          Which log file to read. 0=current log file.
+        </desc>
+      </param>
+      <param name="offset" type="unsigned long long" dir="in">
+        <desc>
+          Offset in the log file.
+        </desc>
+      </param>
+      <param name="size" type="unsigned long long" dir="in">
+        <desc>
+          Chunk size to read in the log file.
+        </desc>
+      </param>
+      <param name="data" type="octet" dir="return" safearray="yes">
+        <desc>
+          Data read from the log file. A data size of 0 means end of file
+          if the requested chunk size was not 0.
+        </desc>
+      </param>
+    </method>
+  </interface>
 
   <!--

trunk/src/VBox/Main/include/MachineImpl.h

@@ -506 +506 @@
     STDMETHOD(HotUnplugCPU(ULONG aCpu));
     STDMETHOD(GetCPUStatus(ULONG aCpu, BOOL *aCpuAttached));
+    STDMETHOD(ReadLog(ULONG aIdx, ULONG64 aOffset, ULONG64 aSize, ComSafeArrayOut(BYTE, aData)));
 
     // public methods only for internal purposes