FILETYPEATTRIBUTEFLAGS-Enumeration (shlwapi.h)

  • Artikel

Gibt FILETYPEATTRIBUTEFLAGS-Konstanten an, die im EditFlags-Wert eines PROGID-Registrierungsschlüssels für die Dateizuordnung verwendet werden.

Syntax

typedef enum {
  FTA_None = 0x00000000,
  FTA_Exclude = 0x00000001,
  FTA_Show = 0x00000002,
  FTA_HasExtension = 0x00000004,
  FTA_NoEdit = 0x00000008,
  FTA_NoRemove = 0x00000010,
  FTA_NoNewVerb = 0x00000020,
  FTA_NoEditVerb = 0x00000040,
  FTA_NoRemoveVerb = 0x00000080,
  FTA_NoEditDesc = 0x00000100,
  FTA_NoEditIcon = 0x00000200,
  FTA_NoEditDflt = 0x00000400,
  FTA_NoEditVerbCmd = 0x00000800,
  FTA_NoEditVerbExe = 0x00001000,
  FTA_NoDDE = 0x00002000,
  FTA_NoEditMIME = 0x00008000,
  FTA_OpenIsSafe = 0x00010000,
  FTA_AlwaysUnsafe = 0x00020000,
  FTA_NoRecentDocs = 0x00100000,
  FTA_SafeForElevation = 0x00200000,
  FTA_AlwaysUseDirectInvoke = 0x00400000
} FILETYPEATTRIBUTEFLAGS;

Konstanten

 
FTA_None
Wert: 0x00000000
Keine FILETYPEATTRIBUTEFLAGS-Optionen festgelegt.
FTA_Exclude
Wert: 0x00000001
Schließt den Dateityp aus.
FTA_Show
Wert: 0x00000002
Zeigt Dateitypen wie Ordner an, die keiner Dateinamenerweiterung zugeordnet sind.
FTA_HasExtension
Wert: 0x00000004
Gibt an, dass der Dateityp über eine Dateinamenerweiterung verfügt.
FTA_NoEdit
Wert: 0x00000008
Untersagt das Bearbeiten der diesem Dateityp zugeordneten Registrierungseinträge, das Hinzufügen neuer Einträge und das Löschen oder Ändern vorhandener Einträge.
FTA_NoRemove
Wert: 0x00000010
Verhindert das Löschen der Registrierungseinträge, die diesem Dateityp zugeordnet sind.
FTA_NoNewVerb
Wert: 0x00000020
Verhindert das Hinzufügen neuer Verben zum Dateityp.
FTA_NoEditVerb
Wert: 0x00000040
Untersagt das Ändern oder Löschen kanonischer Verben wie Öffnen und Drucken.
FTA_NoRemoveVerb
Wert: 0x00000080
Untersagt das Löschen kanonischer Verben wie Öffnen und Drucken.
FTA_NoEditDesc
Wert: 0x00000100
Untersagt das Ändern oder Löschen der Beschreibung des Dateityps.
FTA_NoEditIcon
Wert: 0x00000200
Verhindert das Ändern oder Löschen des Symbols, das dem Dateityp zugewiesen ist.
FTA_NoEditDflt
Wert: 0x00000400
Verhindert die Änderung des Standardverbens.
FTA_NoEditVerbCmd
Wert: 0x00000800
Verhindert die Änderung der Befehle , die Verben zugeordnet sind.
FTA_NoEditVerbExe
Wert: 0x00001000
Untersagt das Ändern oder Löschen von Verben.
FTA_NoDDE
Wert: 0x00002000
Untersagt die Änderung oder Löschung der Einträge im Zusammenhang mit DDE.
FTA_NoEditMIME
Wert: 0x00008000
Untersagt das Ändern oder Löschen des Inhaltstyps und der Standarderweiterungseinträge.
FTA_OpenIsSafe
Wert: 0x00010000
Gibt an, dass das geöffnete Verb des Dateityps für heruntergeladene Dateien sicher aufgerufen werden kann. Dieses Flag gilt nur für sichere Dateitypen, die von AssocIsDangerous identifiziert werden. Um die Benutzerfreundlichkeit zu verbessern und unnötige Benutzeraufforderungen beim Herunterladen und Aktivieren von Elementen zu reduzieren, sollten Dateitypbesitzer dieses Flag angeben, und Anwendungen, die Dateien herunterladen und aktivieren, sollten dieses Flag respektieren.
FTA_AlwaysUnsafe
Wert: 0x00020000
Verhindert, dass das Kontrollkästchen Nie fragen sie mich aktiviert wird. Die Verwendung dieses Flags bedeutet FTA_OpenIsSafe nicht beachtet wird und AssocIsDangerous immer TRUE zurückgibt.
Wenn Ihr Dateityp Code ausführen kann, sollten Sie immer dieses Flag verwenden oder sicherstellen, dass die Dateityphandler Risiken minimieren, z. B. durch Erstellen von Warnaufforderungen vor dem Ausführen des Codes.

Der Benutzer kann dieses Attribut über das Dialogfeld Dateityp außer Kraft setzen.
FTA_NoRecentDocs
Wert: 0x00100000
Verhindert das Hinzufügen von Membern dieses Dateityps zum Ordner Zuletzt verwendete Dokumente . Darüber hinaus wird in Windows 7 und höher das Hinzufügen von Membern dieses Dateityps zur automatischen Kategorie Zuletzt oder Häufig der Sprungliste einer Anwendung untersagt.

Dieses Flag schränkt nicht ein, dass Elemente dieses Dateityps zu einer benutzerdefinierten Sprungliste hinzugefügt werden. Außerdem gibt es keine Einschränkung für den Dateityp, der dem automatischen Jump-Listen anderer Anwendungen hinzugefügt wird, falls andere Anwendungen diesen Dateityp verwenden.
FTA_SafeForElevation
Wert: 0x00200000
In Windows 8 eingeführt. Kennzeichnet das Datei- oder URI-Schema als sicher, das von einer Anwendung mit geringer Vertrauenswürdigheit verwendet werden kann. Dateien, die aus dem Internet oder einem App-Container stammen, sind Beispiele, bei denen die Datei als nicht vertrauenswürdig gilt. Nicht vertrauenswürdige Dateien, die Code enthalten, sind besonders gefährlich, und es müssen geeignete Sicherheitsminderungen angewendet werden, wenn die Datei von einer voll vertrauenswürdigen Anwendung geöffnet werden soll. Dateitypbesitzer für Dateiformate, die die Möglichkeit haben, Code auszuführen, sollten dieses Flag nur angeben, wenn ihr Programm Bedrohungen durch Rechteerweiterungen entschärft, die mit der Ausführung von Code auf einer höheren Integritätsebene verknüpft sind. Zu den Entschärfungen gehören das Auffordern des Benutzers vor der Ausführung von Code oder das Ausführen des Codes mit reduzierten Berechtigungen.

Durch Angeben dieses Flags für einen gesamten Dateityp kann eine App, die in einem App-Container ausgeführt wird, Dateien dieses Typs an ein Programm übergeben, das mit voller Vertrauenswürdigkeit ausgeführt wird. Einige Dateitypen werden aufgrund ihrer Fähigkeit zum Ausführen von Code als inhärent gefährlich erkannt und werden blockiert, wenn Sie diesen Wert nicht angeben.
FTA_AlwaysUseDirectInvoke
Wert: 0x00400000
In Windows 8 eingeführt. Stellt sicher, dass die Verben für den Dateityp mit einem URI anstelle einer heruntergeladenen Version der Datei aufgerufen werden. Verwenden Sie dieses Flag nur, wenn Sie das Verb des Dateityps registriert haben, um DirectInvoke über die SupportedProtocols- oder UseUrl-Registrierung zu unterstützen.

Hinweise

Diese Flags stellen mögliche Attribute dar, die im EditFlags-Wert einer ProgID-Registrierung gespeichert sind. Die EditFlags-Daten sind eine einzelne REG_DWORD.

Das folgende Beispiel zeigt die Attribute FTA_NoRemove (0x00000010) und FTA_NoNewVerb (0x00000020), die dem Dateityp ".myp" zugewiesen sind.

HKEY_CLASSES_ROOT
   .myp
      (Default) = MyProgram.1
   MyProgram.1
      (Default) = MyProgram Application
      EditFlags = 0x00000030
\

APIs wie IQueryAssociations::GetData können diese EditFlags-Daten abrufen. Vergleichen Sie die numerischen Entsprechungen dieser FILETYPEATTRIBUTEFLAGS-Flags mit dem abgerufenen Wert, um zu bestimmen, welche Flags festgelegt sind.

Im folgenden Beispiel wird die Verwendung von IQueryAssociations::GetData veranschaulicht, um zu bestimmen, ob diese Werte festgelegt sind.

IQueryAssociations *passoc;

HRESULT hr = AssocCreate(CLSID_QueryAssociations, IID_PPV_ARGS(&passoc));
if (SUCCEEDED(hr))
{
    hr = passoc->Init(NULL, pszType, NULL, NULL);
    if (SUCCEEDED(hr))
    {
        DWORD dwEditFlags;
        ULONG cb = sizeof(dwEditFlags);
        
        hr = passoc->GetData(NULL, ASSOCDATA_EDITFLAGS, NULL, &dwEditFlags, &cb);
        if (SUCCEEDED(hr))
        {
            if (dwEditFlags & 0x00000010) // FTA_NoRemove
            {
                // ...
            }    
            if (dwEditFlags & 0x00000020)  // FTA_NoNewVerb
            {
                // ...
            }
        }
    }
    passoc->Release();
}

Um ein EditFlags-Attribut festzulegen, können Sie die Funktionen RegSetValueEx oder SHSetValue verwenden. Verwenden Sie zunächst IQueryAssociations::GetData , um den aktuellen Attributsatz abzurufen, wie im obigen Beispiel gezeigt, fügen Sie dem Wert den gewünschten FILETYPEATTRIBUTEFLAGS-Wert hinzu, und schreiben Sie diesen Wert dann mithilfe einer der beiden Setfunktionen zurück in die Registrierung.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP, Windows 2000 Professional, Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile shlwapi.h