The command: a GUID such as {11213A01-...}, a leaf name, or a slash-separated path. Prefer the GUID, the one form that does not depend on the host's language.
OptionalsubGUID of a dynamic child of the command; only with the GUID form. Empty is the same as absent.
Parameters for
menu.runMainMenuCommand. Run a main-menu command addressed by GUID, leaf name or slash-separated path. A disabled command fails withMENU_ITEM_DISABLED. Paths match every ancestor; a wrong prefix never falls back to a leaf name. Ambiguous identities fail withMENU_MATCH_AMBIGUOUSanddetails.candidates; a missing name/path isMENU_COMMAND_NOT_FOUND, a missing GUID isNOT_FOUND. Addressing a dynamic leaf by GUID requires both GUIDs. Unreadable state fails withOPERATION_FAILED. The call answers when the command returns: one that shows a modal dialog, such as renaming a playlist, answers only after the dialog closes.