Changeset 82488 in vbox for trunk/include/VBox/HostServices

Timestamp:

Dec 7, 2019 3:42:27 AM (5 years ago)

Author:

vboxsync

Message:

VBoxSharedClipboardSvc: Return VERR_NOT_IMPLEMENTED like we used to do for everything which isn't defined (VERR_ACCESS_DENIED isn't appropriate). This means introducing (and updating) a VBOX_SHCL_GUEST_FN_LAST define in the public header. bugref:9437

File:

• trunk/include/VBox/HostServices/VBoxClipboardSvc.h (modified) (4 diffs)

trunk/include/VBox/HostServices/VBoxClipboardSvc.h

@@ -293 +293 @@
  *
  * @deprecated Replaced by VBOX_SHCL_GUEST_FN_MSG_PEEK_WAIT,
- *             VBOX_SHCL_GUEST_FN_MSG_GET, VBOX_SHCL_GUEST_FN_MSG_CANCEL.
+ *             VBOX_SHCL_GUEST_FN_MSG_GET, VBOX_SHCL_GUEST_FN_CANCEL.
  */
 #define VBOX_SHCL_GUEST_FN_GET_HOST_MSG_OLD       1
@@ -313 +313 @@
 #define VBOX_SHCL_GUEST_FN_DATA_WRITE             4
 
-/** Does the actual protocol handshake. If this message is not
- *  being sent by the guest, the host handles that particular client
- *  with the legacy protocol (v0).
+/** Does the actual protocol handshake.
+ *
+ * If this message is not being sent by the guest, the host handles that
+ * particular client with the legacy protocol (v0).
  *
  * @retval  VINF_SUCCESS on success.
@@ -339 +340 @@
 /** Query the host ones feature masks.
  *
- * That way the guest (client) can get hold of the features
- * from the host.  Again, it is prudent to set the 127 bit and observe it being
- * cleared on success, as older hosts might return success without doing
- * anything.
+ * That way the guest (client) can get hold of the features from the host.
+ * Again, it is prudent to set the 127 bit and observe it being cleared on
+ * success, as older hosts might return success without doing anything.
  *
  * @retval  VINF_SUCCESS on success.
@@ -533 +533 @@
  */
 #define VBOX_SHCL_GUEST_FN_ERROR                  27
+
+/** The last function number (used for validation/sanity).   */
+#define VBOX_SHCL_GUEST_FN_LAST                   VBOX_SHCL_GUEST_FN_ERROR
 /** @} */