Enumeração ASSOCF

Fornece informação para os métodos de interface 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

Nenhuma das seguintes opções está definida.

ASSOCF_INIT_NOREMAPCLSID

Instrui os métodos da interface IQueryAssociations a não mapearem valores CLSID para valores ProgID.

ASSOCF_INIT_BYEXENAME

Identifica o valor do parâmetro pwszAssoc de IQueryAssociations::Init como nome de ficheiro executável. Se esta flag não estiver definida, a chave raiz será definida para o ProgID associado à chave.exe em vez do ProgID do ficheiro executável.

ASSOCF_OPEN_BYEXENAME

Idêntico ao ASSOCF_INIT_BYEXENAME.

ASSOCF_INIT_DEFAULTTOSTAR

Especifica que, quando um método IQueryAssociations não encontra o valor solicitado sob a chave raiz, deve tentar recuperar o valor comparável da * subchave.

ASSOCF_INIT_DEFAULTTOFOLDER

Especifica que, quando um método IQueryAssociations não encontra o valor solicitado sob a chave raiz, deve tentar recuperar o valor comparável da subchave da Pasta .

ASSOCF_NOUSERSETTINGS

Especifica que apenas HKEY_CLASSES_ROOT devem ser revistadas e que HKEY_CURRENT_USER devem ser ignoradas.

ASSOCF_NOTRUNCATE

Especifica que a cadeia de retorno não deve ser truncada. Em vez disso, devolve um valor de erro e o tamanho necessário para a cadeia completa.

ASSOCF_VERIFY

Instrui a IQueryAssociations métodos para verificar que os dados são precisos. Esta configuração permite que os métodos IQueryAssociations leiam dados do disco rígido do utilizador para verificação. Por exemplo, podem verificar o nome amigo no registo com o guardado no ficheiro .exe. Definir esta bandeira normalmente reduz a eficiência do método.

ASSOCF_REMAPRUNDLL

Instrui o IQueryAssociations a ignorar Rundll.exe e a devolver informações sobre o seu alvo. Normalmente, os métodos IQueryAssociations retornam informação sobre o primeiro .exe ou .dll numa cadeia de comandos. Se um comando usar Rundll.exe, ao definir este flag, o método indica ao método para ignorar Rundll.exe e devolver informação sobre o seu alvo.

ASSOCF_NOFIXUPS

Instrui métodos IQueryAssociations para não corrigir erros no registo, como o nome amigável de uma função que não corresponde ao encontrado no ficheiro .exe.

ASSOCF_IGNOREBASECLASS

Especifica que o valor BaseClass deve ser ignorado.

ASSOCF_INIT_IGNOREUNKNOWN

Introduzido no Windows 7. Especifica que o ProgID "Desconhecido" deve ser ignorado; em vez disso, falha.

ASSOCF_INIT_FIXED_PROGID

Introduzido no Windows 8. Especifica que o ProgID fornecido deve ser mapeado usando as definições do sistema, em vez das definições atuais do utilizador.

ASSOCF_IS_PROTOCOL

Introduzido no Windows 8. Especifica que o valor é um protocolo e deve ser mapeado usando os valores predefinidos do utilizador atual.

ASSOCF_INIT_FOR_FILE

Introduzido no Windows 8.1. Especifica que o ProgID corresponde a uma associação baseada em extensão de ficheiro. Use com ASSOCF_INIT_FIXED_PROGID.

ASSOCF_IS_FULL_URI

Introduzido na Atualização Aniversário do Windows 10. Especifica que o URI http/https completo está a ser passado para resolução alvo. Apenas um dos ASSOCF_INIT_FIXED_PROGID, ASSOCF_IS_PROTOCOL ou ASSOCF_IS_FULL_URI pode ser especificado de cada vez.

ASSOCF_PER_MACHINE_ONLY

Introduzido na Atualização Aniversário do Windows 10. Aplica apenas a pesquisa por associação por máquina e evita HKEY_CURRENT_USER.

ASSOCF_APP_TO_APP

Introduzido na Atualização do Windows 10 de abril de 2018. Instrui os métodos IQueryAssociations a incluir app-to-app (aplicações para websites, manipuladores de URI a partir de aplicações empacotadas) ao resolver.

Requirements

Requisito Value
Cliente mínimo suportado Windows 2000 Professional, Windows XP [apenas aplicações de ambiente de trabalho]
Servidor mínimo suportado Windows 2000 Server [apenas aplicações de ambiente de trabalho]
Cabeçalho Shlwapi.h

Ver também

AssocQueryKeyAssocQueryStringAssocQueryStringByKey

 

 

© Microsoft 2017. Todos os direitos reservados.

  • Last updated on