Changeset 103442 in vbox for trunk/include/VBox/GuestHost/SharedClipboard-transfers.h

Timestamp:

Feb 19, 2024 1:51:37 PM (12 months ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

161773

Message:

Shared Clipboard: Condensed more code by adding a SHCLTRANSFERCALLBACKS::pfnOnInitialize() callback function. bugref:9437

File:

• trunk/include/VBox/GuestHost/SharedClipboard-transfers.h (modified) (2 diffs)

trunk/include/VBox/GuestHost/SharedClipboard-transfers.h

@@ -810 +810 @@
  * Shared Clipboard transfer callback table.
  *
- * All callbacks are optional (hence all returning void).
+ * All callbacks are optional.
+ * Callbacks which can veto the caller have a return value.
  */
 typedef struct _SHCLTRANSFERCALLBACKS
@@ -820 +821 @@
      */
     DECLCALLBACKMEMBER(void,  pfnOnCreated,(PSHCLTRANSFERCALLBACKCTX pCbCtx));
+    /**
+     * Called when the transfer gets initialized.
+     *
+     * @return  VBox status code. On error the intialization will will be treated as failed.
+     * @param   pCbCtx              Pointer to callback context to use.
+    */
+    DECLCALLBACKMEMBER(int,  pfnOnInitialize,(PSHCLTRANSFERCALLBACKCTX pCbCtx));
     /**
      * Called after the transfer got initialized.