Instalação da NFSeLibrary.dll

Várias funções da NFSeLibrary utilizam recursos da DLL NFSeLibrary.dll, que é licenciada por CNPJ emitente e precisa ser instalada em cada máquina que executará estas funcionalidades.

A DLL é fornecida junto com a Library em um arquivo compactado no formato .zip à parte. Os arquivos da DLL devem ser colocados obrigatoriamente no mesmo diretório do seu programa compilado, conforme imagem que segue:


PastaDLL

No caso de aplicações VDF é a pasta Programs da Workspace.

A DLL requer o Framework .NET 2.0 instalado.

Para registrar a DLL no Windows XP/2003/2008 basta dar um duplo-clique no arquivo registraNFSeLibrary.bat. Se for Windows Vista/7 é necessário que o Controle de Conta de Usuários esteja desabilitado e deve-se clicar com o botão direito e escolher a opção "Executar como administrador".

Na grande maioria dos casos em que o registro da DLL falha em máquinas com Win XP é por  falta do Framework do .NET ou por problemas em sua instalação. Nestes casos a instalação de todas as atualizações críticas e opcionais disponíveis no Windows Update geralmente resolvem o problema.

Em máquinas com Windows Vista/7 a falha no registro deve-se na maior parte das vezes pela não desativação do Controle de Contas de Usuários, ou por não ter usado a opção "Executar como Administrador" para processar o arquivo .bat.

A única exceção que encontramos até agora na falha do registro que não se enquadrou nas situações descritas acima foi a de um Windows XP 64 Bits. Neste caso foi necessário substituir o arquivo RegAsm.exe fornecido pela DLL pelo que estava no diretório de instalação do Framework. Entretanto este foi um caso isolado, pois grande parte dos desenvolvedores usam Windows 7 64 Bits, os quais não tiveram nenhum problema para registrar a DLL com o arquivo RegAsm.exe fornecido junto com a DLL. Então é possível que este detalhe seja realmente específico para o Windows XP 64 Bits.

Usando a pasta Programs em driver mapeado

Oficialmente a DLL não é suportada para uso via rede. Ou seja, a pasta Programs deve estar local na máquina que irá executar a aplicação que faz uso da DLL.

Muitos desenvolvedores, por questões de desempenho, trabalham com a pasta Programs localmente. Para estes nenhuma informação adicional é necessária. Para quem usa o Terminal Server, idem.

Para quem deixa a pasta Programs na rede, o macete é copiar a pasta Programs para a máquina do usuário, registrar a DLL, apagar a pasta Programs local e criar o atalho para a aplicação apontando para a rede.