ASSOCF-Enumeration

Artikel
06/13/2023

Stellt Informationen für die IQueryAssociations-Schnittstellenmethoden bereit .

Syntax

typedef enum  {
    ASSOCF_NONE                  = 0x00000000,  
    ASSOCF_INIT_NOREMAPCLSID     = 0x00000001,  
    ASSOCF_INIT_BYEXENAME        = 0x00000002,  
    ASSOCF_OPEN_BYEXENAME        = 0x00000002,  
    ASSOCF_INIT_DEFAULTTOSTAR    = 0x00000004,  
    ASSOCF_INIT_DEFAULTTOFOLDER  = 0x00000008,  
    ASSOCF_NOUSERSETTINGS        = 0x00000010,  
    ASSOCF_NOTRUNCATE            = 0x00000020,  
    ASSOCF_VERIFY                = 0x00000040,  
    ASSOCF_REMAPRUNDLL           = 0x00000080,  
    ASSOCF_NOFIXUPS              = 0x00000100,  
    ASSOCF_IGNOREBASECLASS       = 0x00000200,  
    ASSOCF_INIT_IGNOREUNKNOWN    = 0x00000400,  
    ASSOCF_INIT_FIXED_PROGID     = 0x00000800,  
    ASSOCF_IS_PROTOCOL           = 0x00001000,  
    ASSOCF_INIT_FOR_FILE         = 0x00002000
} ASSOCF;

Konstanten

ASSOCF_NONE

Keine der folgenden Optionen ist festgelegt.

ASSOCF_INIT_NOREMAPCLSID

Weist IQueryAssociations-Schnittstellenmethoden an, CLSID-Werte nicht ProgID-Werten zuzuordnen.

ASSOCF_INIT_BYEXENAME

Gibt den Wert des pwszAssoc-Parameters von IQueryAssociations::Init als ausführbaren Dateinamen an. Wenn dieses Flag nicht festgelegt ist, wird der Stammschlüssel auf die ProgID festgelegt, die dem .exe Schlüssel zugeordnet ist, anstatt auf die ProgID der ausführbaren Datei.

ASSOCF_OPEN_BYEXENAME

Identisch mit ASSOCF_INIT_BYEXENAME.

ASSOCF_INIT_DEFAULTTOSTAR

Gibt an, dass, wenn eine IQueryAssociations-Methode den angeforderten Wert nicht unter dem Stammschlüssel findet, versucht werden soll, den vergleichbaren Wert aus dem * Unterschlüssel abzurufen.

ASSOCF_INIT_DEFAULTTOFOLDER

Gibt an, dass, wenn eine IQueryAssociations-Methode den angeforderten Wert unter dem Stammschlüssel nicht findet, versucht werden soll, den vergleichbaren Wert aus dem Ordner-Unterschlüssel abzurufen.

ASSOCF_NOUSERSETTINGS

Gibt an, dass nur HKEY_CLASSES_ROOT durchsucht werden soll und dass HKEY_CURRENT_USER ignoriert werden sollen.

ASSOCF_NOTRUNCATE

Gibt an, dass die Rückgabezeichenfolge nicht abgeschnitten werden soll. Geben Sie stattdessen einen Fehlerwert und die erforderliche Größe für die vollständige Zeichenfolge zurück.

ASSOCF_VERIFY

Weist IQueryAssociations-Methoden an, die Richtigkeit der Daten zu überprüfen. Mit dieser Einstellung können IQueryAssociations-Methoden Zur Überprüfung Daten von der Festplatte des Benutzers lesen. Sie können beispielsweise den Anzeigenamen in der Registrierung mit dem in der .exe-Datei gespeicherten Namen überprüfen. Das Festlegen dieses Flags verringert in der Regel die Effizienz der Methode.

ASSOCF_REMAPRUNDLL

Weist IQueryAssociations-Methoden an, Rundll.exe zu ignorieren und Informationen zum Ziel zurückzugeben. IQueryAssociations-Methoden geben in der Regel Informationen zum ersten .exe oder .dll in einer Befehlszeichenfolge zurück. Wenn ein Befehl Rundll.exe verwendet, weist das Festlegen dieses Flags die Methode an, Rundll.exe zu ignorieren und Informationen über das Ziel zurückzugeben.

ASSOCF_NOFIXUPS

Weist IQueryAssociations-Methoden an, Fehler in der Registrierung nicht zu beheben, z. B. der Anzeigename einer Funktion, die nicht mit dem in der .exe-Datei übereinstimmt.

ASSOCF_IGNOREBASECLASS

Gibt an, dass der BaseClass-Wert ignoriert werden soll.

ASSOCF_INIT_IGNOREUNKNOWN

In Windows 7 eingeführt. Gibt an, dass die ProgID "Unknown" ignoriert werden soll. tritt stattdessen ein Fehler auf.

ASSOCF_INIT_FIXED_PROGID

In Windows 8 eingeführt. Gibt an, dass die angegebene ProgID mit den Systemstandardeinstellungen und nicht mit den aktuellen Benutzerstandardeinstellungen zugeordnet werden soll.

ASSOCF_IS_PROTOCOL

In Windows 8 eingeführt. Gibt an, dass der Wert ein Protokoll ist und mit den aktuellen Benutzerstandardeinstellungen zugeordnet werden soll.

ASSOCF_INIT_FOR_FILE

In Windows 8.1 eingeführt. Gibt an, dass die ProgID einer dateierweiterungsbasierten Zuordnung entspricht. Verwenden Sie zusammen mit ASSOCF_INIT_FIXED_PROGID.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Shlwapi.h

Siehe auch

AssocQueryKeyAssocQueryStringAssocQueryStringByKey