Enumeração ASSOCF

Artigo
06/12/2023

Fornece informações 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;

Constantes

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 o ProgID associado à 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 na chave raiz, ele deverá tentar recuperar o valor comparável da * subchave.

ASSOCF_INIT_DEFAULTTOFOLDER

Especifica que quando um método IQueryAssociations não encontra o valor solicitado na chave raiz, ele deve 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 marcar 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 usar Rundll.exe, definir esse sinalizador instrui o método a 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 à encontrada no arquivo .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, falhe.

ASSOCF_INIT_FIXED_PROGID

Introduzido no Windows 8. Especifica que o ProgID fornecido deve ser mapeado usando os padrões do sistema, em vez dos padrões 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 de usuário atuais.

ASSOCF_INIT_FOR_FILE

Introduzido no 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.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	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

Confira também

AssocQueryKeyAssocQueryStringAssocQueryStringByKey