Criar Manipuladores de Extensão de Shell

Artigo
06/12/2023

Os recursos do Shell podem ser estendidos com entradas do Registro e arquivos .ini. Embora essa abordagem para estender o Shell seja simples e adequada para muitas finalidades, ela é limitada. Por exemplo, se você usar o Registro para especificar um ícone personalizado para um tipo de arquivo, o mesmo ícone aparecerá para cada arquivo desse tipo. Estender o Shell com o registro não permite que você varie o ícone para arquivos diferentes do mesmo tipo. Outros aspectos do Shell, como a folha de propriedades Propriedades que pode ser exibida quando um arquivo é clicado com o botão direito do mouse, não podem ser modificados com o registro.

Uma abordagem mais poderosa e flexível para estender o Shell é implementar manipuladores de extensão de shell. Esses manipuladores podem ser implementados para uma variedade de ações que o Shell pode executar. Antes de executar a ação, o Shell consulta o manipulador de extensão, dando a ele a oportunidade de modificar a ação. Um exemplo comum é um manipulador de extensão de menu de atalho. Se um for implementado para um tipo de arquivo, ele será consultado sempre que um dos arquivos for clicado com o botão direito do mouse. Em seguida, o manipulador pode especificar itens de menu adicionais em uma base arquivo a arquivo, em vez de ter o mesmo conjunto para todo o tipo de arquivo.

Este documento discute como implementar os manipuladores de extensão que permitem modificar uma variedade de ações do Shell. Os manipuladores a seguir são associados a um tipo de arquivo específico e permitem que você especifique em uma base arquivo a arquivo:

Manipulador	Descrição
Manipulador de menu de atalho	Chamado antes que o menu de atalho de um arquivo seja exibido. Ele permite que você adicione itens ao menu de atalho em uma base arquivo a arquivo.
Manipulador de dados	Chamado quando uma operação de arrastar e soltar é executada em objetos dragShell. Ele permite que você forneça formatos de área de transferência adicionais para o destino de soltar.
Manipulador de soltar	Chamado quando um objeto de dados é arrastado ou descartado em um arquivo. Ele permite que você transforme um arquivo em um destino de soltar.
Manipulador de ícones	Chamado antes que o ícone de um arquivo seja exibido. Ele permite que você substitua o ícone padrão do arquivo por um ícone personalizado em uma base arquivo a arquivo.
Manipulador de folha de propriedades	Chamado antes que a folha de propriedades propriedades de um objeto seja exibida. Ele permite que você adicione ou substitua páginas.
Manipulador de imagem em miniatura	Fornece uma imagem para representar o item.
Manipulador de infodicas	Fornece texto pop-up quando o usuário passa o ponteiro do mouse sobre o objeto .
Manipulador de metadados	Fornece acesso de leitura e gravação a metadados (propriedades) armazenados em um arquivo. Isso pode ser usado para estender a exibição Detalhes, dicas de informações, a página de propriedades e os recursos de agrupamento.

Outros manipuladores não estão associados a um tipo de arquivo específico, mas são chamados antes de algumas operações do Shell:

Manipulador	Descrição
Manipulador de coluna	Chamado pelo Windows Explorer antes de exibir a exibição Detalhes de uma pasta. Ele permite que você adicione colunas personalizadas à exibição Detalhes.
Manipulador de gancho de cópia	Chamado quando um objeto de pasta ou impressora está prestes a ser movido, copiado, excluído ou renomeado. Ele permite que você aprove ou vete a operação.
Manipulador do tipo "arrastar e soltar"	Chamado quando um arquivo é arrastado com o botão direito do mouse. Ele permite que você modifique o menu de atalho exibido.
Manipulador de sobreposição de ícone	Chamado antes que o ícone de um arquivo seja exibido. Ele permite que você especifique uma sobreposição para o ícone do arquivo.
Manipulador de pesquisa	Chamado para iniciar um mecanismo de pesquisa. Ele permite implementar um mecanismo de pesquisa personalizado acessível no menu Iniciar ou no Windows Explorer.

Os detalhes de como implementar manipuladores de extensão específicos são abordados nas seções listadas acima. O restante deste documento aborda alguns problemas de implementação comuns a todos os manipuladores de extensão do Shell.

Implementando manipuladores de extensão do Shell
Aprimoramento da Pesquisa do Windows com manipuladores de extensão do Shell
Registrando manipuladores de extensão de shell
Tópicos relacionados

Implementando manipuladores de extensão do Shell

Grande parte da implementação de um objeto de manipulador de extensão shell depende de seu tipo. Há, no entanto, alguns elementos comuns. Esta seção discute os aspectos da implementação que são compartilhados por todos os manipuladores de extensão do Shell.

Muitos manipuladores de extensão shell são objetos COM (Component Object Model) em processo. Eles devem ser atribuídos a um GUID e registrados conforme descrito em Registrando manipuladores de extensão do shell. Elas são implementadas como DLLs e devem exportar as seguintes funções padrão:

DllMain. O ponto de entrada padrão para a DLL.
DllGetClassObject. Expõe a fábrica de classes do objeto.
DllCanUnloadNow. O COM chama essa função para determinar se o objeto está atendendo clientes. Caso contrário, o sistema pode descarregar a DLL e liberar a memória associada.

Como todos os objetos COM, os manipuladores de extensão do Shell devem implementar uma interface IUnknown e uma fábrica de classes. A maioria dos manipuladores de extensão também deve implementar uma interface IPersistFile ou IShellExtInit no Windows XP ou anterior. Eles foram substituídos por IInitializeWithStream, IInitializeWithItem e IInitializeWithFile no Windows Vista. O Shell usa essas interfaces para inicializar o manipulador.

A interface IPersistFile deve ser implementada pelo seguinte:

Manipuladores de dados
Remover manipuladores

No passado, manipuladores de ícone também eram necessários para implementar IPersistFile, mas isso não é mais verdade. Para manipuladores de ícones, IPersistFile agora é opcional e outras interfaces, como IInitializeWithItem , são preferenciais.

A interface IShellExtInit deve ser implementada pelo seguinte:

Manipuladores de menu de atalho
Manipuladores de arrastar e soltar
Manipuladores de folha de propriedades

Implementando IPersistFile

A interface IPersistFile destina-se a permitir que um objeto seja carregado ou salvo em um arquivo de disco. Ele tem seis métodos além de IUnknown, cinco deles próprios e o método GetClassID que herda do IPersist. Com as extensões do Shell, o IPersist é usado apenas para inicializar um objeto de manipulador de extensão shell. Como normalmente não há necessidade de ler ou gravar no disco, somente os métodos GetClassID e Load exigem uma implementação nãontoken.

O Shell chama GetClassID primeiro e a função retorna o CLSID (identificador de classe) do objeto do manipulador de extensão. Em seguida, o Shell chama Load e passa dois valores. O primeiro, pszFileName, é uma cadeia de caracteres Unicode com o nome do arquivo ou pasta em que o Shell está prestes a operar. O segundo é dwMode, que indica o modo de acesso ao arquivo. Como normalmente não há necessidade de acessar arquivos, dwMode geralmente é zero. O método armazena esses valores conforme necessário para referência posterior.

O fragmento de código a seguir ilustra como um manipulador de extensão shell típico implementa os métodos GetClassID e Load . Ele foi projetado para lidar com ANSI ou Unicode. CLSID_SampleExtHandler é o GUID do objeto do manipulador de extensão e CSampleExtHandler é o nome da classe usada para implementar a interface. As variáveis m_szFileName e m_dwMode são variáveis privadas usadas para armazenar o nome do arquivo e os sinalizadores de acesso.

wchar_t m_szFileName[MAX_PATH];    // The file name
DWORD m_dwMode;                  // The file access mode

CSampleExtHandler::GetClassID(CLSID *pCLSID)
{
    *pCLSID = CLSID_SampleExtHandler;
}

CSampleExtHandler::Load(PCWSTR pszFile, DWORD dwMode)
{
    m_dwMode = dwMode;
    return StringCchCopy(_szFileName, ARRAYSIZE(m_szFileName), pszFile);
}

Implementando IShellExtInit

A interface IShellExtInit tem apenas um método, IShellExtInit::Initialize, além de IUnknown. O método tem três parâmetros que o Shell pode usar para passar vários tipos de informações. Os valores passados dependem do tipo de manipulador e alguns podem ser definidos como NULL.

pIDFolder contém o ponteiro de uma pasta para uma PIDL (lista de identificadores de item). Para extensões de folha de propriedades, é NULL. Para extensões de menu de atalho, é o PIDL da pasta que contém o item cujo menu de atalho está sendo exibido. Para manipuladores não padrão de arrastar e soltar, é o PIDL da pasta de destino.
pDataObject mantém um ponteiro para a interface IDataObject de um objeto de dados. O objeto de dados contém um ou mais nomes de arquivo no formato CF_HDROP .
hRegKey contém uma chave do Registro para o objeto de arquivo ou o tipo de pasta.

O método IShellExtInit::Initialize armazena o nome do arquivo, o ponteiro IDataObject e a chave do Registro conforme necessário para uso posterior. O fragmento de código a seguir ilustra uma implementação de IShellExtInit::Initialize. Para simplificar, este exemplo pressupõe que o objeto de dados contenha apenas um único arquivo. Em geral, ele pode conter vários arquivos que precisarão ser extraídos.

LPCITEMIDLIST  m_pIDFolder;           //The folder's PIDL
wchar_t        m_szFile[MAX_PATH];    //The file name
IDataObject   *m_pDataObj;            //The IDataObject pointer
HKEY           m_hRegKey;             //The file or folder's registry key

STDMETHODIMP CShellExt::Initialize(LPCITEMIDLIST pIDFolder, 
                                   IDataObject *pDataObj, 
                                   HKEY hRegKey) 
{ 
    // If Initialize has already been called, release the old PIDL
    ILFree(m_pIDFolder);
    m_pIDFolder = nullptr;

    // Store the new PIDL.
    if (pIDFolder)
    {
        m_pIDFolder = ILClone(pIDFolder);
    }
    
    // If Initialize has already been called, release the old
    // IDataObject pointer.
    if (m_pDataObj)
    { 
        m_pDataObj->Release(); 
    }
     
    // If a data object pointer was passed in, save it and
    // extract the file name. 
    if (pDataObj) 
    { 
        m_pDataObj = pDataObj; 
        pDataObj->AddRef(); 
      
        STGMEDIUM   medium;
        FORMATETC   fe = {CF_HDROP, NULL, DVASPECT_CONTENT, -1, TYMED_HGLOBAL};
        UINT        uCount;

        if (SUCCEEDED(m_pDataObj->GetData(&fe, &medium)))
        {
            // Get the count of files dropped.
            uCount = DragQueryFile((HDROP)medium.hGlobal, (UINT)-1, NULL, 0);

            // Get the first file name from the CF_HDROP.
            if (uCount)
                DragQueryFile((HDROP)medium.hGlobal, 0, m_szFile, 
                              sizeof(m_szFile)/sizeof(TCHAR));

            ReleaseStgMedium(&medium);
        }
    }

    // Duplicate the registry handle. 
    if (hRegKey) 
        RegOpenKeyEx(hRegKey, nullptr, 0L, MAXIMUM_ALLOWED, &m_hRegKey); 
    return S_OK; 
}

CSampleExtHandler é o nome da classe usada para implementar a interface . As variáveis m_pIDFolder, m_pDataObject, m_szFileName e m_hRegKey são variáveis privadas usadas para armazenar as informações passadas. Para simplificar, este exemplo pressupõe que apenas um nome de arquivo será mantido pelo objeto de dados. Depois que a estrutura FORMATETC é recuperada do objeto de dados, DragQueryFile é usado para extrair o nome do arquivo do membro medium.hGlobal da estrutura FORMATETC. Se uma chave do Registro for passada, o método usará RegOpenKeyEx para abrir a chave e atribuirá o identificador a m_hRegKey.

Personalização da dica de informações

Há duas maneiras de personalizar dicas de informações:

Implemente um objeto que dê suporte a IQueryInfo e registre esse objeto sob a subchave adequada no registro (consulte Registrando manipuladores de extensão do shell abaixo).
Especifique uma cadeia de caracteres fixa ou uma lista de propriedades de arquivo específicas a serem exibidas.

Para exibir uma cadeia de caracteres fixa para uma extensão de namespace, crie uma entrada chamada InfoTip na chave {CLSID} da extensão de namespace. Defina o valor dessa entrada como a cadeia de caracteres literal que você deseja exibir, conforme mostrado neste exemplo, ou uma cadeia de caracteres indireta que especifica um recurso e um índice dentro desse recurso (para fins de localização).

HKEY_CLASSES_ROOT
   CLSID
      {CLSID}
         InfoTip = InfoTip string for your namespace extension

Para exibir uma cadeia de caracteres fixa para um tipo de arquivo, crie uma entrada chamada InfoTip na chave ProgID desse tipo de arquivo. Defina o valor dessa entrada como a cadeia de caracteres literal que você deseja exibir ou uma cadeia de caracteres indireta que especifica um recurso e um índice dentro desse recurso (para fins de localização), conforme mostrado neste exemplo.

HKEY_CLASSES_ROOT
   ProgID
      InfoTip = Resource.dll, 3

Se você quiser que o Shell exiba propriedades de arquivo específicas na dica de informações para um tipo de arquivo específico, crie uma entrada chamada InfoTip na chave ProgID para esse tipo de arquivo. Defina o valor dessa entrada como uma lista delineada por ponto-e-vírgula de nomes de propriedade canônica, pares de IDENTIFICADOR de formato (FMTID)/PID (identificador de propriedade) ou ambos. Esse valor deve começar com "prop:" para identificá-lo como uma cadeia de caracteres de lista de propriedades. Se você omitir "prop:", o valor será visto como uma cadeia de caracteres literal e exibido como tal.

No exemplo a seguir, propname é um nome de propriedade canônica (como System.Date) e {fmtid},pid é um par FMTID/PID .

HKEY_CLASSES_ROOT
   ProgID
      InfoTip = prop:propname;propname;{fmtid},pid;{fmtid},pid

Os seguintes nomes de propriedade podem ser usados:

Nome da propriedade	Descrição	Recuperado de
Autor	Autor do documento	PIDSI_AUTHOR
Título	Título do documento	PIDSI_TITLE
Assunto	Resumo do assunto	PIDSI_SUBJECT
Comentário	Comentários do documento	PIDSI_COMMENT ou propriedades de pasta/driver
PageCount	Número de páginas	PIDSI_PAGECOUNT
Nome	Nome amigável	Exibição de pasta padrão
OriginalLocation	Local do arquivo original	Pasta de maleta e pasta Lixeira
DateDeleted	O arquivo de data foi excluído	Pasta Lixeira
Tipo	Tipo de arquivo	Exibição de detalhes da pasta padrão
Tamanho	Tamanho do arquivo	Exibição de detalhes da pasta padrão
SyncCopyIn	O mesmo que OriginalLocation	O mesmo que OriginalLocation
Modificado	Data da última modificação	Exibição de detalhes da pasta padrão
Criado	Data de criação	Exibição de detalhes da pasta padrão
Acessado	Data de acesso pela última vez	Exibição de detalhes da pasta padrão
InFolder	Diretório que contém o arquivo	Resultados da pesquisa de documentos
Rank	Qualidade da correspondência de pesquisa	Resultados da pesquisa de documentos
FreeSpace	Espaço de armazenamento disponível	Unidades de disco
NumberOfVisits	Número de visitas	Pasta Favoritos
Atributos	Atributos do arquivo	Exibição de detalhes da pasta padrão
Empresa	Nome da empresa	PIDDSI_COMPANY
Categoria	Categoria do documento	PIDDSI_CATEGORY
Direitos autorais	Direitos autorais de mídia	PIDMSI_COPYRIGHT
HTMLInfoTipFile	Arquivo HTML InfoTip	Desktop.ini arquivo para pasta

Aprimorando a Pesquisa do Windows com manipuladores de extensão do Shell

Os manipuladores de extensão do Shell podem ser usados para aprimorar a experiência do usuário fornecida por um manipulador de protocolo do Windows Search. Para habilitar esses aprimoramentos, o manipulador de extensão shell de suporte deve ser projetado para integrar-se ao manipulador de protocolo de pesquisa como uma fonte de dados. Para obter informações sobre como aprimorar um manipulador de protocolo do Windows Search por meio da integração com um manipulador de extensão do Shell, consulte Adicionando ícones, visualizações e menus de atalho. Para obter mais informações sobre manipuladores de protocolo do Windows Search, consulte Desenvolvendo manipuladores de protocolo.

Registrando manipuladores de extensão de shell

Um objeto de manipulador de extensão shell deve ser registrado antes que o Shell possa usá-lo. Esta seção é uma discussão geral sobre como registrar um manipulador de extensão do Shell.

Sempre que você cria ou altera um manipulador de extensão do Shell, é importante notificar o sistema de que você fez uma alteração com SHChangeNotify, especificando o evento SHCNE_ASSOCCHANGED . Se você não chamar SHChangeNotify, a alteração poderá não ser reconhecida até que o sistema seja reinicializado.

Assim como acontece com todos os objetos COM, você deve criar um GUID para o manipulador usando uma ferramenta como UUIDGEN.exe. Crie uma chave em HKEY_CLASSES_ROOT\CLSID cujo nome é a forma de cadeia de caracteres do GUID. Como os manipuladores de extensão do Shell são servidores em processo, você deve criar uma chave InProcServer32 sob a chave GUID com o valor padrão definido como o caminho da DLL do manipulador. Use o modelo de threading Apartment.

Sempre que o Shell executa uma ação que pode envolver um manipulador de extensão do Shell, ele verifica a chave do Registro apropriada. A chave sob a qual um manipulador de extensão é registrado controla, portanto, quando ele será chamado. Por exemplo, é uma prática comum ter um manipulador de menu de atalho chamado quando o Shell exibe um menu de atalho para um membro de um tipo de arquivo. Nesse caso, o manipulador deve ser registrado sob a chave ProgID do tipo de arquivo.

Nomes de manipulador

Para habilitar um manipulador de extensão shell, crie uma subchave com o nome da subchave do manipulador (veja abaixo) na subchave ShellEx do ProgID (para tipos de arquivo) ou o nome do tipo de objeto Shell (para Objetos shell predefinidos).

Por exemplo, se você quisesse registrar um manipulador de extensão de menu de atalho para MyProgram.1, começaria criando a seguinte subchave:

HKEY_CLASSES_ROOT
   MyProgram.1
      ShellEx
         ContextMenuHandlers

Para os manipuladores a seguir, crie uma subchave abaixo da chave "Nome da subchave do manipulador" cujo nome é a versão de cadeia de caracteres do CLSID da extensão shell. Várias extensões podem ser registradas na chave de nome da subchave do manipulador criando várias subchaves.

Manipulador	Interface	Nome da subchave do manipulador
Manipulador de menu de atalho	Icontextmenu	ContextMenuHandlers
Manipulador de copyhook	ICopyHook	CopyHookHandlers
Manipulador do tipo "arrastar e soltar"	Icontextmenu	DragDropHandlers
Manipulador de folha de propriedades	IShellPropSheetExt	PropertySheetHandlers
Manipulador de provedor de colunas (preterido no Windows Vista)	IColumnProvider	ColumnHandlers

Para os manipuladores a seguir, o valor padrão da chave "Nome da Subchave do Manipulador" é a versão da cadeia de caracteres do CLSID da extensão shell. Somente uma extensão pode ser registrada para esses manipuladores.

Manipulador	Interface	Nome da subchave do manipulador
Manipulador de dados	Idataobject	Datahandler
Manipulador de remoção	Idroptarget	DropHandler
Manipulador de ícones	IExtractIconA/W	IconHandler
Manipulador de imagens	IExtractImage	{BB2E617C-0920-11d1-9A0B-00C04FC2D6C1}
Manipulador de imagens em miniatura	IThumbnailProvider	{E357FCCD-A995-4576-B01F-234630154E96}
Manipulador de infodicas	IQueryInfo	{00021500-0000-0000-C000-000000000046}
Link do Shell (ANSI )	IShellLinkA	{000214EE-0000-0000-C000-000000000046}
Link do Shell (UNICODE)	IShellLinkW	{000214F9-0000-0000-C000-000000000046}
Armazenamento estruturado	IStorage	{0000000B-0000-0000-C000-000000000046}
Metadados	Ipropertystore	PropertyHandler
Metadados	IPropertySetStorage (preterido no Windows Vista)	PropertyHandler
Fixar no Menu Iniciar	IStartMenuPinnedList	{a2a9545d-a0c2-42b4-9708-a0b2badd77c8}
Fixar à barra de tarefas		{90AA3A4E-1CBA-4233-B8BB-535773D48449}

As subchaves especificadas para adicionar Pin ao Menu Iniciar e Fixar na Barra de Tarefas ao menu de atalho de um item só são necessárias para tipos de arquivo que incluem a entrada IsShortCut .

O suporte para manipuladores de provedor de colunas foi removido no Windows Vista. Além disso, a partir do Windows Vista, IPropertySetStorage foi preterido em favor do IPropertyStore.

Embora IExtractImage permaneça com suporte, IThumbnailProvider é preferencial para o Windows Vista e posterior.

Objetos shell predefinidos

O Shell define objetos adicionais em HKEY_CLASSES_ROOT que podem ser estendidos da mesma forma que os tipos de arquivo. Por exemplo, para adicionar um manipulador de folha de propriedades para todos os arquivos, você pode se registrar na chave PropertySheetHandlers .

HKEY_CLASSES_ROOT
   *
      shellex
         PropertySheetHandlers

A tabela a seguir fornece as várias subchaves de HKEY_CLASSES_ROOT sob as quais os manipuladores de extensão podem ser registrados. Observe que muitos manipuladores de extensão não podem ser registrados em todas as subchaves listadas. Para obter mais detalhes, consulte a documentação do manipulador específico.

Subchave	Descrição	Manipuladores possíveis	Versão
*	Todos os arquivos	Menu de Atalho, Folha de Propriedades, Verbos (veja abaixo)	Tudo
AllFileSystemObjects	Todos os arquivos e pastas de arquivo	Menu de atalho, folha de propriedades, verbos	4,71
Pasta	Todas as pastas	Menu de atalho, folha de propriedades, verbos	Tudo
Diretório	Pastas de arquivo	Menu de atalho, folha de propriedades, verbos	Tudo
Directory\Background	Plano de fundo da pasta de arquivo	Somente menu de atalho	4,71
Dirigir	Todas as unidades no MyComputer, como "C:\"	Menu de atalho, folha de propriedades, verbos	Tudo
Rede	Rede inteira (em Meus Locais de Rede)	Menu de atalho, folha de propriedades, verbos	Tudo
Network\Type\ #	Todos os objetos do tipo # (veja abaixo)	Menu de atalho, Folha de Propriedades, Verbos	4,71
Netshare	Todos os compartilhamentos de rede	Menu de atalho, Folha de Propriedades, Verbos	4,71
NetServer	Todos os servidores de rede	Menu de atalho, Folha de Propriedades, Verbos	4,71
network_provider_name	Todos os objetos fornecidos pelo provedor de rede "network_provider_name"	Menu de atalho, Folha de Propriedades, Verbos	Tudo
Impressoras	Todas as impressoras	Menu de atalho, folha de propriedades	Tudo
Audiocd	CD de áudio na unidade de CD	Somente verbos	Tudo
DVD	Unidade de DVD (Windows 2000)	Menu de atalho, folha de propriedades, verbos	4,71

Observações:

O menu de atalho em segundo plano da pasta de arquivos é acessado clicando com o botão direito do mouse em uma pasta de arquivo, mas não sobre qualquer conteúdo da pasta.
"Verbos" são comandos especiais registrados em HKEY_CLASSES_ROOT\Subkey\Shell\Verb .
ParaTipo\# de Rede\ , "#" é um código de tipo de provedor de rede em decimal. O código de tipo de provedor de rede é a palavra alta de um tipo de rede. A lista de tipos de rede é fornecida no arquivo de cabeçalho Winnetwk.h (valores WNNC_NET_*). Por exemplo, WNNC_NET_SHIVA é 0x00330000, portanto, a chave de tipo correspondente seria HKEY_CLASSES_ROOT\Tipo\ deRede\51 .
"network_provider_name" é um nome de provedor de rede, conforme especificado por WNetGetProviderName, com os espaços convertidos em sublinhados. Por exemplo, se o provedor de rede da Microsoft Networking estiver instalado, seu nome de provedor será "Microsoft Windows Network" e o network_provider_name correspondente será Microsoft_Windows_Network.

Exemplo de um registro de manipulador de extensão

Para habilitar um manipulador específico, crie uma subchave na chave de tipo do manipulador de extensão com o nome do manipulador. O Shell não usa o nome do manipulador, mas deve ser diferente de todos os outros nomes sob essa subchave de tipo. Defina o valor padrão da subchave de nome para a forma de cadeia de caracteres do GUID do manipulador.

O exemplo a seguir ilustra as entradas do Registro que habilitam manipuladores de extensão de folha de propriedades e menu de atalho, usando um exemplo de tipo de arquivo .myp:

HKEY_CLASSES_ROOT
   .myp
      (Default) = MyProgram.1
   CLSID
      {00000000-1111-2222-3333-444444444444}
         InProcServer32
            (Default) = C:\MyDir\MyCommand.dll
            ThreadingModel = Apartment
      {11111111-2222-3333-4444-555555555555}
         InProcServer32
            (Default) = C:\MyDir\MyPropSheet.dll
            ThreadingModel = Apartment
   MyProgram.1
      (Default) = MyProgram Application
      Shellex
         ContextMenuHandler
            MyCommand
               (Default) = {00000000-1111-2222-3333-444444444444}
         PropertySheetHandlers
            MyPropSheet
               (Default) = {11111111-2222-3333-4444-555555555555}

O procedimento de registro discutido nesta seção deve ser seguido para todos os sistemas Windows.

Diretrizes para implementar extensões de In-Process

Compartilhar via

Criar Manipuladores de Extensão de Shell

Implementando manipuladores de extensão do Shell

Implementando IPersistFile

Implementando IShellExtInit

Personalização da dica de informações

Aprimorando a Pesquisa do Windows com manipuladores de extensão do Shell

Registrando manipuladores de extensão de shell

Nomes de manipulador

Objetos shell predefinidos

Exemplo de um registro de manipulador de extensão

Comentários

Recursos adicionais

Compartilhar via

Criar Manipuladores de Extensão de Shell

Implementando manipuladores de extensão do Shell

Implementando IPersistFile

Implementando IShellExtInit

Personalização da dica de informações

Aprimorando a Pesquisa do Windows com manipuladores de extensão do Shell

Registrando manipuladores de extensão de shell

Nomes de manipulador

Objetos shell predefinidos

Exemplo de um registro de manipulador de extensão

Tópicos relacionados

Comentários

Recursos adicionais