Wyliczenie ASSOCF

Zawiera informacje dotyczące metod interfejsu IQueryAssociations .

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_IS_FULL_URI           = 0x00004000,
    ASSOCF_PER_MACHINE_ONLY      = 0x00008000,
    ASSOCF_APP_TO_APP            = 0x00010000,
} ASSOCF;

Constants

ASSOCF_NONE

Żadna z poniższych opcji nie jest ustawiona.

ASSOCF_INIT_NOREMAPCLSID

Instruuje metody interfejsu IQueryAssociations , aby nie mapować wartości CLSID na wartości ProgID.

ASSOCF_INIT_BYEXENAME

Identyfikuje wartość parametru pwszAssocIQueryAssociations::Init jako nazwę pliku wykonywalnego. Jeśli ta flaga nie jest ustawiona, klucz główny zostanie ustawiony na identyfikator ProgID skojarzony z kluczem .exe zamiast identyfikatorem ProgID pliku wykonywalnego.

ASSOCF_OPEN_BYEXENAME

Identyczne z ASSOCF_INIT_BYEXENAME.

ASSOCF_INIT_DEFAULTTOSTAR

Określa, że gdy metoda IQueryAssociations nie znajdzie żądanej wartości w kluczu głównym, powinna podjąć próbę pobrania porównywalnej wartości z podklucza * .

ASSOCF_INIT_DEFAULTTOFOLDER

Określa, że gdy metoda IQueryAssociations nie znajdzie żądanej wartości w kluczu głównym, powinna podjąć próbę pobrania porównywalnej wartości z podklucza Folder .

ASSOCF_NOUSERSETTINGS

Określa, że należy przeszukiwać tylko HKEY_CLASSES_ROOT i że HKEY_CURRENT_USER powinny być ignorowane.

ASSOCF_NOTRUNCATE

Określa, że ciąg zwracany nie powinien być obcięty. Zamiast tego zwróć wartość błędu i wymagany rozmiar dla kompletnego ciągu.

ASSOCF_VERIFY

Instruuje metody IQueryAssociations , aby sprawdzić, czy dane są dokładne. To ustawienie umożliwia metodom IQueryAssociations odczytywanie danych z dysku twardego użytkownika na potrzeby weryfikacji. Na przykład mogą sprawdzić przyjazną nazwę w rejestrze względem nazwy przechowywanej w pliku .exe. Ustawienie tej flagi zwykle zmniejsza wydajność metody.

ASSOCF_REMAPRUNDLL

Instruuje metody IQueryAssociations , aby ignorować Rundll.exe i zwracać informacje o jego obiekcie docelowym. Zazwyczaj metody IQueryAssociations zwracają informacje o pierwszej .exe lub .dll w ciągu polecenia. Jeśli polecenie używa Rundll.exe, ustawienie tej flagi informuje metodę o ignorowaniu Rundll.exe i zwracaniu informacji o jego obiekcie docelowym.

ASSOCF_NOFIXUPS

Instruuje metody IQueryAssociations , aby nie usuwać błędów w rejestrze, takich jak przyjazna nazwa funkcji nie pasującej do tej, która znajduje się w pliku .exe.

ASSOCF_IGNOREBASECLASS

Określa, że wartość BaseClass powinna być ignorowana.

ASSOCF_INIT_IGNOREUNKNOWN

Wprowadzone w Windows 7. Określa, że identyfikator progID "Nieznany" powinien być ignorowany; zamiast tego nie powiedzie się.

ASSOCF_INIT_FIXED_PROGID

Wprowadzone w Windows 8. Określa, że podany identyfikator ProgID powinien być mapowany przy użyciu domyślnych ustawień systemowych, a nie bieżących wartości domyślnych użytkownika.

ASSOCF_IS_PROTOCOL

Wprowadzone w Windows 8. Określa, że wartość jest protokołem i powinna być mapowana przy użyciu bieżących wartości domyślnych użytkownika.

ASSOCF_INIT_FOR_FILE

Wprowadzone w Windows 8.1. Określa, że identyfikator ProgID odpowiada skojarzeniu opartemu na rozszerzeniu pliku. Użyj razem z ASSOCF_INIT_FIXED_PROGID.

ASSOCF_IS_FULL_URI

Wprowadzone w Windows 10 rocznicowej aktualizacji. Określa, że pełny identyfikator URI http/https jest przekazywany do rozpoznawania docelowego. Jednocześnie można określić tylko jedną z ASSOCF_INIT_FIXED_PROGID, ASSOCF_IS_PROTOCOL lub ASSOCF_IS_FULL_URI.

ASSOCF_PER_MACHINE_ONLY

Wprowadzone w Windows 10 rocznicowej aktualizacji. Wymusza tylko wyszukiwanie skojarzeń poszczególnych maszyn i pozwala uniknąć HKEY_CURRENT_USER.

ASSOCF_APP_TO_APP

Wprowadzono w aktualizacji z Windows 10 kwietnia 2018 r. Instruuje metody IQueryAssociations w celu uwzględnienia aplikacji do aplikacji (aplikacji dla witryn internetowych, procedur obsługi identyfikatorów URI z spakowanych aplikacji) podczas rozpoznawania.

Requirements

Requirement	Value
Minimalny obsługiwany klient	Windows 2000 Professional, Windows XP [tylko aplikacje klasyczne]
Minimalny obsługiwany serwer	Windows 2000 Server [tylko aplikacje klasyczne]
Nagłówka	Shlwapi.h

Zobacz także

AssocQueryKeyAssocQueryStringAssocQueryStringByKey

 

 

© Microsoft 2017 r. Wszelkie prawa zastrzeżone.