From 26a029d407be480d791972afb5975cf62c9360a6 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Fri, 19 Apr 2024 02:47:55 +0200 Subject: Adding upstream version 124.0.1. Signed-off-by: Daniel Baumann --- xpcom/io/nsILocalFileWin.idl | 98 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 98 insertions(+) create mode 100644 xpcom/io/nsILocalFileWin.idl (limited to 'xpcom/io/nsILocalFileWin.idl') diff --git a/xpcom/io/nsILocalFileWin.idl b/xpcom/io/nsILocalFileWin.idl new file mode 100644 index 0000000000..a3f80d391b --- /dev/null +++ b/xpcom/io/nsILocalFileWin.idl @@ -0,0 +1,98 @@ +/* -*- Mode: Java; 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 "nsIFile.idl" + +%{C++ +struct PRFileDesc; +%} + +[ptr] native PRFileDescStar(PRFileDesc); + +[scriptable, builtinclass, uuid(e7a3a954-384b-4aeb-a5f7-55626b0de9be)] +interface nsILocalFileWin : nsIFile +{ + /** + * initWithCommandLine + * + * Initialize this object based on the main app path of a commandline + * handler. + * + * @param aCommandLine + * the commandline to parse an app path out of. + */ + void initWithCommandLine(in AString aCommandLine); + /** + * getVersionInfoValue + * + * Retrieve a metadata field from the file's VERSIONINFO block. + * Throws NS_ERROR_FAILURE if no value is found, or the value is empty. + * + * @param aField The field to look up. + * + */ + AString getVersionInfoField(in string aField); + + /** + * The canonical path of the file, which avoids short/long + * pathname inconsistencies. The nsIFile persistent + * descriptor is not guaranteed to be canonicalized (it may + * persist either the long or the short path name). The format of + * the canonical path will vary with the underlying file system: + * it will typically be the short pathname on filesystems that + * support both short and long path forms. + */ + [noscript] readonly attribute AString canonicalPath; + + /** + * Get or set whether this file is marked read-only. + * + * Throws NS_ERROR_FILE_INVALID_PATH for an invalid file. + * Throws NS_ERROR_FAILURE if the set or get fails. + */ + attribute bool readOnly; + + /** + * Setting this to true will prepend the prefix "\\?\" to all parsed file + * paths which match ^[A-Za-z]:\\.* (regex) syntax. + * + * There are two known issues (and potentially more) which can be resolved + * by the prefix: + * - In the Windows API, the maximum length for a path is MAX_PATH in + * general. However, Windows API has many functions that also have Unicode + * versions to permit an extended-length path for a maximum total path + * length of 32,767 characters. + * + * - A path component which ends with a dot is not allowed for Windows + * API. + * + * If either of these issues are expected to be common in your code, you + * should set this flag to true. (You should probably not have to set this + * flag to true.) + */ + attribute boolean useDOSDevicePathSyntax; + + /** + * Identical to nsIFile::openNSPRFileDesc except it also uses the + * FILE_SHARE_DELETE flag. + */ + [noscript] PRFileDescStar openNSPRFileDescShareDelete(in long flags, + in long mode); + + /** + * Return the Windows-specific file attributes of this file. + */ + [noscript] unsigned long getWindowsFileAttributes(); + + /** + * Set or clear the Windows specific file attributes of this file. + * + * @param aSetAttrs Attribute to set on the file. + * @param aClearAttrs Attributes to clear on the file. + */ + [noscript] void setWindowsFileAttributes(in unsigned long aSetAttrs, + in unsigned long aClearAttrs); +}; -- cgit v1.2.3