Compartilhar via


Enumeração ASSOCSTR (shlwapi.h)

Usado por IQueryAssociations::GetString para definir o tipo de cadeia de caracteres que deve ser retornado.

Syntax

typedef enum {
  ASSOCSTR_COMMAND = 1,
  ASSOCSTR_EXECUTABLE,
  ASSOCSTR_FRIENDLYDOCNAME,
  ASSOCSTR_FRIENDLYAPPNAME,
  ASSOCSTR_NOOPEN,
  ASSOCSTR_SHELLNEWVALUE,
  ASSOCSTR_DDECOMMAND,
  ASSOCSTR_DDEIFEXEC,
  ASSOCSTR_DDEAPPLICATION,
  ASSOCSTR_DDETOPIC,
  ASSOCSTR_INFOTIP,
  ASSOCSTR_QUICKTIP,
  ASSOCSTR_TILEINFO,
  ASSOCSTR_CONTENTTYPE,
  ASSOCSTR_DEFAULTICON,
  ASSOCSTR_SHELLEXTENSION,
  ASSOCSTR_DROPTARGET,
  ASSOCSTR_DELEGATEEXECUTE,
  ASSOCSTR_SUPPORTED_URI_PROTOCOLS,
  ASSOCSTR_PROGID,
  ASSOCSTR_APPID,
  ASSOCSTR_APPPUBLISHER,
  ASSOCSTR_APPICONREFERENCE,
  ASSOCSTR_MAX
} ASSOCSTR;

Constantes

 
ASSOCSTR_COMMAND
Valor: 1
Uma cadeia de caracteres de comando associada a um verbo shell.
ASSOCSTR_EXECUTABLE
Um executável de uma cadeia de caracteres de comando de verbo do Shell. Por exemplo, essa cadeia de caracteres é encontrada como o valor (Padrão) de uma subchave, como

HKEY_CLASSES_ROOT\Applicationname\Shell\Aberto\comando. Se o comando usar Rundll.exe, defina o sinalizador ASSOCF_REMAPRUNDLL no parâmetro flags de IQueryAssociations::GetString para recuperar o executável de destino.

Cuidado  

Nem todas as associações de aplicativos têm executáveis. Não suponha que um executável sempre estará presente.


 

Esse tipo de cadeia de caracteres identificará o código que será invocado na implementação do verbo.
ASSOCSTR_FRIENDLYDOCNAME
O nome amigável de um tipo de documento.
ASSOCSTR_FRIENDLYAPPNAME
O nome amigável de um arquivo executável.
ASSOCSTR_NOOPEN
Ignore as informações associadas à subchave aberta .
ASSOCSTR_SHELLNEWVALUE
Procure na subchave ShellNew .
ASSOCSTR_DDECOMMAND
Um modelo para comandos DDE.
ASSOCSTR_DDEIFEXEC
O comando DDE a ser usado para criar um processo.
ASSOCSTR_DDEAPPLICATION
O nome do aplicativo em uma transmissão de DDE.
ASSOCSTR_DDETOPIC
O nome do tópico em uma transmissão de DDE.
ASSOCSTR_INFOTIP
Corresponde ao valor do registro infotip. Retorna uma dica de informações para um item ou uma lista de propriedades na forma de um IPropertyDescriptionList do qual criar uma dica de informações, como ao passar o cursor sobre um nome de arquivo. A lista de propriedades pode ser analisada com PSGetPropertyDescriptionListFromString.
ASSOCSTR_QUICKTIP
Introduzido na Internet Explorer 6. Corresponde ao valor do registro quicktip. O mesmo que ASSOCSTR_INFOTIP, exceto que ele sempre retorna uma lista de nomes de propriedade na forma de um IPropertyDescriptionList. A diferença entre esse valor e ASSOCSTR_INFOTIP é que isso retorna propriedades seguras para qualquer cenário que cause recuperação de propriedade lenta, como redes offline ou lentas. Algumas das propriedades retornadas de ASSOCSTR_INFOTIP podem não ser apropriadas para cenários de recuperação de propriedade lenta. A lista de propriedades pode ser analisada com PSGetPropertyDescriptionListFromString.
ASSOCSTR_TILEINFO
Introduzido na Internet Explorer 6. Corresponde ao valor do registro TileInfo. Contém uma lista de propriedades a serem exibidas para um tipo de arquivo específico em uma janela do Windows Explorer que está no modo de exibição de bloco. Isso é o mesmo que ASSOCSTR_INFOTIP, mas, como ASSOCSTR_QUICKTIP, ele também retorna uma lista de nomes de propriedades na forma de um IPropertyDescriptionList. A lista de propriedades pode ser analisada com PSGetPropertyDescriptionListFromString.
ASSOCSTR_CONTENTTYPE
Introduzido na Internet Explorer 6. Descreve um tipo geral de associação de arquivo MIME, como imagem e bmp, para que os aplicativos possam fazer suposições gerais sobre um tipo de arquivo específico.
ASSOCSTR_DEFAULTICON
Introduzido na Internet Explorer 6. Retorna o caminho para os recursos de ícone a serem usados por padrão para essa associação. Números positivos indicam um índice na tabela de recursos da dll, enquanto números negativos indicam uma ID do recurso. Um exemplo da sintaxe do recurso é "c:\myfolder\myfile.dll,-1".
ASSOCSTR_SHELLEXTENSION
Introduzido na Internet Explorer 6. Para um objeto que tem uma extensão shell associada a ele, você pode usá-la para recuperar o CLSID desse objeto de extensão shell passando uma representação de cadeia de caracteres do IID da interface que você deseja recuperar como o parâmetro pwszExtra de IQueryAssociations::GetString. Por exemplo, se você quiser recuperar um manipulador que implementa a interface IExtractImage , especifique "{BB2E617C-0920-11d1-9A0B-00C04FC2D6C1}", que é a IID de IExtractImage.
ASSOCSTR_DROPTARGET
Introduzido na Internet Explorer 8. Para um verbo invocado por meio de COM e da interface IDropTarget , você pode usar esse sinalizador para recuperar o CLSID do objeto IDropTarget . Esse CLSID está registrado na subchave DropTarget . O verbo é especificado no parâmetro pwszExtra na chamada para IQueryAssociations::GetString.

Esse tipo de cadeia de caracteres identificará o código que será invocado na implementação do verbo.
ASSOCSTR_DELEGATEEXECUTE
Introduzido na Internet Explorer 8. Para um verbo invocado por meio de COM e da interface IExecuteCommand , você pode usar esse sinalizador para recuperar o CLSID do objeto IExecuteCommand . Esse CLSID é registrado na subchave de comando do verbo como a entrada DelegateExecute. O verbo é especificado no parâmetro pwszExtra na chamada para IQueryAssociations::GetString.

Esse tipo de cadeia de caracteres identificará o código que será invocado na implementação do verbo.
ASSOCSTR_SUPPORTED_URI_PROTOCOLS
Um valor de cadeia de caracteres dos esquemas de protocolo URI. Por exemplo, http:https:ftp:file: ou * indicando tudo.
ASSOCSTR_PROGID
Introduzido em Windows 10. O ProgID fornecido pelo aplicativo associado ao tipo de arquivo ou esquema de URI. Isso se for configurado pelos usuários nas configurações padrão do programa.
ASSOCSTR_APPID
Introduzido em Windows 10. O AppUserModelID do aplicativo associado ao tipo de arquivo ou esquema de URI. Isso é configurado pelos usuários em suas configurações de programa padrão.
ASSOCSTR_APPPUBLISHER
Introduzido em Windows 10. O editor do aplicativo associado ao tipo de arquivo ou esquema de URI. Isso é configurado pelos usuários em suas configurações de programa padrão.
ASSOCSTR_APPICONREFERENCE
Introduzido em Windows 10. A referência de ícone do aplicativo associado ao tipo de arquivo ou esquema de URI. Isso é configurado pelos usuários em suas configurações de programa padrão.
ASSOCSTR_MAX
O valor máximo definido de ASSOCSTR, usado para fins de validação.

Requisitos

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