Procedimentos: depurar uma aplicação com permissão para direitosHow-to: debug a rights-enabled application

O tópico seguinte mostra como depurar a aplicação e utilizar o Registo de Eventos do Windows.The following topic shows how to debug your application and use the Windows Event Log.

Depurar a aplicaçãoDebugging your application

No SDK Rights Management Services 2.1, as verificações antidepuração na versão de programador do nosso tempo de execução estão desativadas.In Rights Management Services SDK 2.1, the anti-debugging checks in the developer version of our runtime are disabled.

Pode ativar o rastreio de depuração utilizando a seguinte chave de registo.You can turn on debug tracing by using the following registry key. (Para desativar o rastreio de depuração, altere o valor para 0.) Não é necessário mais nada para a depuração nesta versão.(To turn debug tracing off, change the value to 0.) Nothing else is required for debugging in this release.

HKEY_LOCAL_MACHINE
   SOFTWARE
      Microsoft
         MSIPC
            "Trace" = 00000001
            Data type
            dword

Registo de aplicações ao utilizar o Registo de Eventos do WindowsApplication logging by using the Windows Event Log

O nome do registo de eventos é “Microsoft-RMS-MSIPC/Depuração”.The name of the event log is "Microsoft-RMS-MSIPC/Debug". Isto significa que, no Visualizador de Eventos do Windows, o seu registo aparece como “Registos de Aplicações e Serviços\Microsoft\RMS\MSIPC\Depuração”.This means that in the Windows Event Viewer, your log appears as "Application and Services Logs\Microsoft\RMS\MSIPC\Debug".

Nota O registo está ativado por predefinição e definido para verbosidade de nível 3.Note The log is enabled by default and set to verbosity level 3.

Para alterar as definições da funcionalidade de registo, pode utilizar a IU do Visualizador de Eventos do Windows ou o Wevtutil, uma ferramenta de linha de comandos incorporada no Windows.To change the settings of the logging feature, you can use either the UI for the Windows Event Viewer or Wevtutil, a command line tool built into Windows.

Através da interface do Wevtutil, pode controlar o nível de verbosidade do seu registo.Through the Wevtutil interface, you can control the level of verbosity of your log.

De momento, suportamos 3 níveis de registo:At this time, we support 3 levels of logging:

  • Nível 2 – ErroLevel 2—Error
  • Nível 3 – AvisoLevel 3—Warning
  • Nível 4 – InformaçõesLevel 4—Information

Por exemplo, o comando seguinte ativa o registo de eventos MSIPC e define o nível de verbosidade para informações.For example, the following command will enable the MSIPC event log and set the level of verbosity to information.

wevtutil sl Microsoft-RMS-MSIPC/Debug /e:true /l:4wevtutil sl Microsoft-RMS-MSIPC/Debug /e:true /l:4

Nota No Visualizador de Eventos do Windows, no menu Ver, selecione Mostrar Registos Analíticos e de Depuração para tornar visível o registo de depuração MSIPC.Note In the Windows Event Viewer on the View menu, select Show Analytic and Debug Logs to make the MSIPC Debug log visible.

ComentáriosComments

Antes de inserir um comentário, pedimos-lhe que reveja as nossas Regras básicas.Before commenting, we ask that you review our House rules.