Método IDebugClient5::GetKernelConnectionOptions (dbgeng.h)

  • Artigo

O método GetKernelConnectionOptions retorna as opções de conexão para o destino do kernel atual.

Sintaxe

HRESULT GetKernelConnectionOptions(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG OptionsSize
);

Parâmetros

[out, optional] Buffer

Especifica o buffer para receber as opções de conexão.

[in] BufferSize

Especifica o tamanho em caracteres do buffer Buffer. Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] OptionsSize

Recebe o tamanho em caracteres das opções de conexão. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se OptionsSize for NULL, essas informações não serão retornadas.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno Descrição
S_OK
 O método foi bem-sucedido.
S_FALSE
 O tamanho da cadeia de caracteres era maior que o tamanho do buffer, portanto, ele foi truncado para caber no buffer.
E_UNEXPECTED
 O destino atual não é um destino de kernel dinâmico padrão.

Comentários

Esse método está disponível apenas para destinos de kernel dinâmico que não são locais e não estão conectados por meio do eXDI.

As opções de conexão retornadas são as mesmas opções usadas para se conectar ao kernel.

Para obter mais informações sobre como se conectar a destinos do modo kernel dinâmico, consulte Destinos do Live Kernel-Mode.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

AttachKernel

Idebugclient

IDebugClient2

IDebugClient3

IDebugClient4

IDebugClient5