Compartilhar via

xlfUnregister (Formulário 2)

Aplica-se a: Excel 2013 | Office 2013 | Visual Studio

Pode ser chamado de um comando DLL ou XLL que, por sua vez, foi chamado pelo Microsoft Excel. Isso é equivalente a chamar UNREGISTER de uma planilha de macro do Excel XLM.

xlfUnregister pode ser chamado em dois formulários:

  • Formulário 1: cancela o registro de um comando ou função individual.

  • Formulário 2: descarrega e desativa uma XLL.

Chamada no Formulário 2, essa função força um recurso de DLL ou código a ser descarregado completamente. Ela desabilitará todas as funções em uma DLL, mesmo que elas estejam atualmente em uso por outra macro, não importa qual seja a contagem de uso. Essa função chama xlAutoClose e, em seguida, cancela o registro de todas as funções na DLL.

Excel12(xlfUnregister, LPXLOPER12 pxRes, 1, LPXLOPER12 pxModuleText);

Parâmetros

pxModuleText (xltypeStr)

O nome da DLL.

Valor de propriedade/Valor de retorno

Se for bem-sucedido, retornará TRUE (xltypeBool). Se não tiver êxito, retornará FALSE.

Comentários

Observação

Não chame essa forma da função da implementação do xlAutoClose na tentativa de cancelar o registro de todos os recursos da DLL com uma chamada de função simples. Isso leva a chamadas recursivas de xlAutoClose e um estouro de pilha.

Lembre-se de excluir nomes

Se você especificou o argumento pxFunctionText para xlfRegister, ao registrar as funções e comandos da DLL, você deve excluir explicitamente os nomes chamando xlfSetName para cada um, omitindo o segundo argumento para que a função não apareça mais no Assistente de Função. Confira mais informações em Problemas conhecidos no desenvolvimento de XLL do Excel.

Confira também

  • Last updated on