Package com.sun.jna.platform.win32

Enum-Klasse ShlObj.KNOWN_FOLDER_FLAG

java.lang.Object

java.lang.Enum<ShlObj.KNOWN_FOLDER_FLAG>

com.sun.jna.platform.win32.ShlObj.KNOWN_FOLDER_FLAG

Alle implementierten Schnittstellen:

Serializable, Comparable<ShlObj.KNOWN_FOLDER_FLAG>, Constable

Umschließende Schnittstelle:

ShlObj

public static enum ShlObj.KNOWN_FOLDER_FLAG
extends Enum<ShlObj.KNOWN_FOLDER_FLAG>

KnownFolder flags as used by SHGetKnownFolderPath, SHGetKnownFolderIDList and others. Microsoft Windows SDK 7.0A.

Verschachtelte Klassen - Übersicht

Von Klasse geerbte verschachtelte Klassen/Schnittstellen java.lang.Enum

Enum.EnumDesc<E extends Enum<E>>

Enum-Konstanten - Übersicht

Enum-Konstanten

Enum-Konstante	Beschreibung
ALIAS_ONLY	Introduced in Windows 7.
CREATE	Forces the creation of the specified folder if that folder does not already exist.
DEFAULT_PATH	Gets the default path for a known folder.
DONT_UNEXPAND	Stores the full path in the registry without using environment strings.
DONT_VERIFY	Do not verify the folder's existence before attempting to retrieve the path or IDList.
INIT	Initializes the folder using its Desktop.ini settings.
NO_ALIAS	Gets the true system path for the folder, free of any aliased placeholders such as %USERPROFILE%, returned by SHGetKnownFolderIDList and IKnownFolder::GetIDList.
NO_APPCONTAINER_REDIRECTION	Introduced in Windows 7: When running inside an app container, or when providing an app container token, this flag prevents redirection to app container folders.
NONE	None
NOT_PARENT_RELATIVE	Gets the folder's default path independent of the current location of its parent.
SIMPLE_IDLIST	Build a simple IDList (PIDL) This value can be used when you want to retrieve the file system path but do not specify this value if you are retrieving the localized display name of the folder because it might not resolve correctly.

Methodenübersicht

Modifizierer und Typ	Methode	Beschreibung
int	getFlag()
static ShlObj.KNOWN_FOLDER_FLAG	valueOf(String name)	Gibt die Enum-Konstante dieser Klasse mit dem angegebenen Namen zurück.
static ShlObj.KNOWN_FOLDER_FLAG[]	values()	Gibt ein Array mit den Konstanten dieser Enum-Klasse in der Reihenfolge ihrer Deklaration zurück.

Von Klasse geerbte Methoden java.lang.Enum

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Von Klasse geerbte Methoden java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum-Konstanten - Details

NONE

public static final ShlObj.KNOWN_FOLDER_FLAG NONE

None

SIMPLE_IDLIST

public static final ShlObj.KNOWN_FOLDER_FLAG SIMPLE_IDLIST

Build a simple IDList (PIDL) This value can be used when you want to retrieve the file system path but do not specify this value if you are retrieving the localized display name of the folder because it might not resolve correctly.

NOT_PARENT_RELATIVE

public static final ShlObj.KNOWN_FOLDER_FLAG NOT_PARENT_RELATIVE

Gets the folder's default path independent of the current location of its parent. KF_FLAG_DEFAULT_PATH must also be set.

DEFAULT_PATH

public static final ShlObj.KNOWN_FOLDER_FLAG DEFAULT_PATH

Gets the default path for a known folder. If this flag is not set, the function retrieves the current-and possibly redirected-path of the folder. The execution of this flag includes a verification of the folder's existence unless KF_FLAG_DONT_VERIFY is set.

INIT

public static final ShlObj.KNOWN_FOLDER_FLAG INIT

Initializes the folder using its Desktop.ini settings. If the folder cannot be initialized, the function returns a failure code and no path is returned. This flag should always be combined with KF_FLAG_CREATE.

NO_ALIAS

public static final ShlObj.KNOWN_FOLDER_FLAG NO_ALIAS

Gets the true system path for the folder, free of any aliased placeholders such as %USERPROFILE%, returned by SHGetKnownFolderIDList and IKnownFolder::GetIDList. This flag has no effect on paths returned by SHGetKnownFolderPath and IKnownFolder::GetPath. By default, known folder retrieval functions and methods return the aliased path if an alias exists.

DONT_UNEXPAND

public static final ShlObj.KNOWN_FOLDER_FLAG DONT_UNEXPAND

Stores the full path in the registry without using environment strings. If this flag is not set, portions of the path may be represented by environment strings such as %USERPROFILE%. This flag can only be used with SHSetKnownFolderPath and IKnownFolder::SetPath.

DONT_VERIFY

public static final ShlObj.KNOWN_FOLDER_FLAG DONT_VERIFY

Do not verify the folder's existence before attempting to retrieve the path or IDList. If this flag is not set, an attempt is made to verify that the folder is truly present at the path. If that verification fails due to the folder being absent or inaccessible, the function returns a failure code and no path is returned. If the folder is located on a network, the function might take a longer time to execute. Setting this flag can reduce that lag time.

CREATE

public static final ShlObj.KNOWN_FOLDER_FLAG CREATE

Forces the creation of the specified folder if that folder does not already exist. The security provisions predefined for that folder are applied. If the folder does not exist and cannot be created, the function returns a failure code and no path is returned. This value can be used only with the following functions and methods:

• SHGetKnownFolderPath
• SHGetKnownFolderIDList
• IKnownFolder::GetIDList
• IKnownFolder::GetPath
• IKnownFolder::GetShellItem

NO_APPCONTAINER_REDIRECTION

public static final ShlObj.KNOWN_FOLDER_FLAG NO_APPCONTAINER_REDIRECTION

Introduced in Windows 7: When running inside an app container, or when providing an app container token, this flag prevents redirection to app container folders. Instead, it retrieves the path that would be returned where it not running inside an app container.

ALIAS_ONLY

public static final ShlObj.KNOWN_FOLDER_FLAG ALIAS_ONLY

Introduced in Windows 7. Return only aliased PIDLs. Do not use the file system path.

Methodendetails

values

public static ShlObj.KNOWN_FOLDER_FLAG[] values()

Gibt ein Array mit den Konstanten dieser Enum-Klasse in der Reihenfolge ihrer Deklaration zurück.

Gibt zurück:

ein Array mit den Konstanten dieser Enum-Klasse in der Reihenfolge ihrer Deklaration

valueOf

public static ShlObj.KNOWN_FOLDER_FLAG valueOf(String name)

Gibt die Enum-Konstante dieser Klasse mit dem angegebenen Namen zurück. Die Zeichenfolge muss exakt mit einer ID übereinstimmen, mit der eine Enum-Konstante in dieser Klasse deklariert wird. (Zusätzliche Leerzeichen sind nicht zulässig.)

Parameter:

name - Name der zurückzugebenden Enumerationskonstante.

Gibt zurück:

Enumerationskonstante mit dem angegebenen Namen

Löst aus:

IllegalArgumentException - wenn diese Enum-Klasse keine Konstante mit dem angegebenen Namen enthält

NullPointerException - wenn das Argument nicht angegeben wird

getFlag

public int getFlag()