estrutura LOAD_DLL_DEBUG_INFO (minwinbase.h)

Contém informações sobre uma DLL (biblioteca de vínculo dinâmico) que acabou de ser carregada.

Sintaxe

typedef struct _LOAD_DLL_DEBUG_INFO {
  HANDLE hFile;
  LPVOID lpBaseOfDll;
  DWORD  dwDebugInfoFileOffset;
  DWORD  nDebugInfoSize;
  LPVOID lpImageName;
  WORD   fUnicode;
} LOAD_DLL_DEBUG_INFO, *LPLOAD_DLL_DEBUG_INFO;

Membros

hFile

Um identificador para a DLL carregada. Se esse membro for NULL, o identificador não será válido. Caso contrário, o membro será aberto para leitura e compartilhamento de leitura no contexto do depurador.

Quando o depurador for concluído com esse arquivo, ele deverá fechar o identificador usando a função CloseHandle .

lpBaseOfDll

Um ponteiro para o endereço base da DLL no espaço de endereço do processo que carrega a DLL.

dwDebugInfoFileOffset

O deslocamento para as informações de depuração no arquivo identificado pelo membro hFile , em bytes. O sistema espera que as informações de depuração estejam no formato CodeView 4.0. Atualmente, esse formato é um derivado do COFF (Common Object File Format).

nDebugInfoSize

O tamanho das informações de depuração no arquivo, em bytes. Se esse membro for zero, não haverá informações de depuração.

lpImageName

Um ponteiro para o nome do arquivo associado ao hFile. Esse membro pode ser NULL ou pode conter o endereço de um ponteiro de cadeia de caracteres no espaço de endereço do processo que está sendo depurado. Esse endereço pode, por sua vez, ser NULL ou apontar para o nome de arquivo real. Se fUnicode for um valor diferente de zero, a cadeia de caracteres de nome será Unicode; caso contrário, é ANSI.

Esse membro é estritamente opcional. Os depuradores devem estar preparados para lidar com o caso em que lpImageName é NULL ou *lpImageName (no espaço de endereço do processo que está sendo depurado) é NULL. Especificamente, o sistema nunca fornecerá um nome de imagem para um evento de processo de criação e provavelmente não passará um nome de imagem para o primeiro evento de DLL. O sistema também nunca fornecerá essas informações no caso de eventos de depuração originados de uma chamada para a função DebugActiveProcess .

fUnicode

Um valor que indica se um nome de arquivo especificado por lpImageName é Unicode ou ANSI. Um valor diferente de zero para esse membro indica Unicode; zero indica ANSI.

Requisitos

Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	minwinbase.h (inclua Windows.h)

Confira também

CREATE_PROCESS_DEBUG_INFO

CREATE_THREAD_DEBUG_INFO

DEBUG_EVENT

DebugActiveProcess