Enumeração ASSOCF

Fornece informações para os métodos de interface IQueryAssociations .

Sintaxe

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 opções a seguir está definida.

ASSOCF_INIT_NOREMAPCLSID

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

ASSOCF_INIT_BYEXENAME

Identifica o valor do parâmetro pwszAssoc de IQueryAssociations::Init como um nome de arquivo executável. Se esse sinalizador não estiver definido, a chave raiz será definida como ProgID associada à chave .exe em vez do ProgID do arquivo executável.

ASSOCF_OPEN_BYEXENAME

Idêntico a ASSOCF_INIT_BYEXENAME.

ASSOCF_INIT_DEFAULTTOSTAR

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

ASSOCF_INIT_DEFAULTTOFOLDER

Especifica que, quando um método IQueryAssociations não encontrar o valor solicitado sob a chave raiz, ele deverá tentar recuperar o valor comparável da subchave Folder .

ASSOCF_NOUSERSETTINGS

Especifica que apenas HKEY_CLASSES_ROOT deve ser pesquisado e que HKEY_CURRENT_USER deve ser ignorado.

ASSOCF_NOTRUNCATE

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

ASSOCF_VERIFY

Instrui os métodos IQueryAssociations a verificar se os dados são precisos. Essa configuração permite que os métodos IQueryAssociations leiam dados do disco rígido do usuário para verificação. Por exemplo, eles podem verificar o nome amigável no registro em relação ao armazenado no arquivo .exe. A configuração desse sinalizador normalmente reduz a eficiência do método.

ASSOCF_REMAPRUNDLL

Instrui os métodos IQueryAssociations a ignorar Rundll.exe e retornar informações sobre seu destino. Normalmente, os métodos IQueryAssociations retornam informações sobre o primeiro .exe ou .dll em uma cadeia de caracteres de comando. Se um comando usa Rundll.exe, definir esse sinalizador informa ao método para ignorar Rundll.exe e retornar informações sobre seu destino.

ASSOCF_NOFIXUPS

Instrui os métodos IQueryAssociations a não corrigir erros no registro, como o nome amigável de uma função que não corresponde ao encontrado no arquivo .exe.

ASSOCF_IGNOREBASECLASS

Especifica que o valor de BaseClass deve ser ignorado.

ASSOCF_INIT_IGNOREUNKNOWN

Introduzido em 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 os padrões do sistema, em vez do padrão do usuário atual.

ASSOCF_IS_PROTOCOL

Introduzido no Windows 8. Especifica que o valor é um protocolo e deve ser mapeado usando os padrões do usuário atual.

ASSOCF_INIT_FOR_FILE

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

ASSOCF_IS_FULL_URI

Introduzido no Windows 10 Atualização de Aniversário. Especifica que o URI http/https completo está sendo aprovado para resolução de destino. Apenas um dos ASSOCF_INIT_FIXED_PROGID, ASSOCF_IS_PROTOCOL ou ASSOCF_IS_FULL_URI pode ser especificado por vez.

ASSOCF_PER_MACHINE_ONLY

Introduzido no Windows 10 Atualização de Aniversário. Impõe somente a pesquisa por associação por computador e evita HKEY_CURRENT_USER.

ASSOCF_APP_TO_APP

Introduzido no Windows 10 Atualização de abril de 2018. Instrui os métodos IQueryAssociations a incluir aplicativo a aplicativo (aplicativos para sites, manipuladores de URI de aplicativos empacotados) ao resolver.

Requirements

Requirement Valor
Cliente mínimo suportado Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho Shlwapi.h

Consulte também

AssocQueryKeyAssocQueryStringAssocQueryStringByKey

 

 

© Microsoft 2017. Todos os direitos reservados.

  • Last updated on