Registrando um item de menu de contexto estático

Os snap-ins administrativos do MMC dos Serviços de Domínio Active Directory e do shell do Windows fornecem um mecanismo para adicionar um item ao menu de contexto exibido para objetos nos Serviços de Domínio Active Directory. O menu de contexto pode invocar qualquer arquivo que possa ser iniciado com a API ShellExecute , como uma URL de aplicativo ou página da Web.

Registrando-se nos Serviços de Domínio Active Directory

O registro da extensão do menu de contexto é específico para uma localidade. Se a extensão do menu de contexto se aplicar a todas as localidades, ela deverá ser registrada no objeto displaySpecifier da classe de objeto em todos os subcontêineres de localidade no contêiner Display Specifiers. Se a extensão do menu de contexto estiver localizada para uma determinada localidade, ela deverá ser registrada no objeto displaySpecifier nesse subcontêiner de localidade. Para obter mais informações sobre o contêiner e as localidades do Display Specifiers, consulte Display Specifiers e DisplaySpecifiers Container.

Há dois atributos especificadores de exibição nos quais um item de menu de contexto estático pode ser registrado, adminContextMenu e shellContextMenu.

O atributo adminContextMenu identifica menus de contexto administrativo a serem exibidos nos snap-ins administrativos dos Serviços de Domínio Active Directory. O menu de contexto aparece quando o usuário exibe o menu de contexto para objetos da classe apropriada em um dos snap-ins administrativos do MMC.

O atributo shellContextMenu identifica os menus de contexto do usuário final a serem exibidos no shell do Windows. O menu de contexto aparece quando o usuário exibe o menu de contexto para objetos da classe apropriada no Windows Explorer. A partir do Windows Server 2003, o shell do Windows não exibe mais objetos que são dos Serviços de Domínio Active Directory.

Todos esses atributos são multivalorados.

Ao registrar um item de menu de contexto estático, os valores para os atributos adminContextMenu e shellContextMenu exigem o seguinte formato.

<order number>,<menu text>,<command>

O "número do pedido"< é um número> não assinado que representa a posição do item no menu de contexto. Quando um menu de contexto é exibido, os valores são classificados usando uma comparação do "<número> do pedido" de cada valor. Se mais de um valor tiver o mesmo "<número> do pedido", essas extensões de menu de contexto serão carregadas na ordem em que forem lidas no servidor do Active Directory. Se possível, use um "número> de pedido"< inexistente, ou seja, que não tenha sido usado por outros valores na propriedade. Não há uma posição inicial prescrita, e lacunas são permitidas na sequência "<número> de ordem".

O "texto> do menu"< é a cadeia de caracteres exibida no menu de contexto. O "texto> do menu" pode incluir um caractere "&"< que precede o caractere de atalho de teclado para o item de menu. Isso fará com que o caractere anterior seja sublinhado. Por exemplo, se o "texto do menu" for "&Arquivo", o texto> do menu será exibido como "Arquivo", o "F" será sublinhado e "F"< será o atalho de teclado para o item de menu.

O "comando>"< é o programa ou arquivo executado pelo snap-in. O caminho completo deve ser especificado ou o arquivo deve existir na variável de ambiente de caminho do computador. O arquivo é chamado usando a função ShellExecute . O "comando>"< não pode conter parâmetros adicionais, por exemplo, Notepad.exe Myfile.txt. Como o ShellExecute é usado, qualquer arquivo ou endereço que possa ser passado para o ShellExecute pode ser usado para "<comando>". Por exemplo, se "command>" contiver "<d:\file.txt", d:\file.txt será aberto com o aplicativo associado à extensão .txt. Da mesma forma, se "command>" contiver "<https://www.fabrikam.com", o navegador da Web padrão será aberto e exibirá a página da Web especificada. Caminhos e nomes de aplicativos com espaços são permitidos. Se "command>"< for um aplicativo, ADsPath e classe do objeto selecionado serão passados como argumentos de linha de comando, separados por um espaço.

No shell do Windows, há suporte para vários itens de menu de contexto de seleção. Nesse caso, o "comando>"< é chamado para cada objeto selecionado. Nos snap-ins administrativos dos Serviços de Domínio Active Directory, não há suporte para itens de menu de contexto estático de seleção múltipla.

Importante

Para o shell do Windows, os dados do especificador de exibição são recuperados no logon do usuário e armazenados em cache para a sessão do usuário. Para os snap-ins administrativos, os dados do especificador de exibição são recuperados quando o snap-in é carregado e armazenado em cache durante o processo. Para o shell do Windows, isso significa que as alterações nos especificadores de exibição entram em vigor depois que um usuário faz logoff e logon novamente. Para os snap-ins administrativos, as alterações entram em vigor quando o snap-in ou o arquivo de console é recarregado; Ou seja, se você iniciar uma nova instância do arquivo de console ou nova instância do Mmc.exe e adicionar o snap-in, os dados mais recentes do especificador de exibição serão recuperados.

 

Para obter mais informações e um exemplo de código, consulte Código de exemplo para instalar um item de menu de contexto estático.