File: nsIWindowsPackageManager.idl

package info (click to toggle)
firefox-esr 128.13.0esr-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 4,230,012 kB
  • sloc: cpp: 7,103,971; javascript: 6,088,450; ansic: 3,653,980; python: 1,212,330; xml: 594,604; asm: 420,652; java: 182,969; sh: 71,124; makefile: 20,747; perl: 13,449; objc: 12,399; yacc: 4,583; cs: 3,846; pascal: 2,973; lex: 1,720; ruby: 1,194; exp: 762; php: 436; lisp: 258; awk: 247; sql: 66; sed: 54; csh: 10
file content (42 lines) | stat: -rw-r--r-- 1,973 bytes parent folder | download | duplicates (11)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
/* -*- Mode: IDL; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#include "nsISupports.idl"

[scriptable, uuid(ad57ac40-52f0-11ec-ada8-4f671255c4aa)]
interface nsIWindowsPackageManager : nsISupports
{
/* Searches for any user installed MSIX packages whose
 * packageFamilyName matches any of the provided `aNamePrefixes`
 * and returns them. The Windows APIs only allow querying user
 * installed packages without elevation, so this will not see any
 * packages installed by another user.
 */
    Array<AString> findUserInstalledPackages(in Array<AString> prefix);

/* When running within a Packaged App environment, returns the
 * InstalledDate of the Package. If called when not running within
 * a Packaged App environment, throws NS_ERROR_NOT_IMPLEMENTED.
 * Any other others will cause NS_ERROR_FAILURE to be thrown.
 */
    unsigned long long getInstalledDate();

/* Asynchronously retrieves the campaignId, if any, a user's Microsoft Store install is
 * associated with. These are present if the user clicked a "ms-window-store://"
 * or "https://" link that included a "cid" query argument the very first time
 * they installed the app. (This value appears to be cached forever, so
 * subsequent installs will not refresh it.) If a non-empty campaign ID is
 * found it will be assumed to be a properly formatted attribution code and
 * have an additional "msstoresignedin" key appended to it indicate whether or
 * not the user was signed in when they installed the application. This key
 * will either be set to "true" or "false".
 *
 * @throw NS_ERROR_NOT_IMPLEMENTED if called on Windows 8 or earlier, or from
 * a non-packaged build.
 * @throw NS_ERROR_FAILURE for any other errors
 */
    [implicit_jscontext]
    Promise campaignId();
};