Método ICOMAdminCatalog2::D umpApplicationInstance (comadmin.h)

Artigo
02/24/2024

Cria um arquivo de despejo que contém uma imagem do estado da instância do aplicativo (processo) especificada.

Nota A partir do Windows Server 2003, somente os administradores têm privilégios de acesso de leitura para os arquivos de despejo COM+.

Sintaxe

HRESULT DumpApplicationInstance(
  [in]          BSTR bstrApplicationInstanceID,
  [in]          BSTR bstrDirectory,
  [in]          long lMaxImages,
  [out, retval] BSTR *pbstrDumpFile
);

Parâmetros

[in] bstrApplicationInstanceID

O GUID da instância do aplicativo.

[in] bstrDirectory

O caminho completo para o diretório no qual o arquivo de despejo é colocado. Não inclua o nome do arquivo. Se esse parâmetro for NULL, o diretório padrão será %SystemRoot%\system32\com\dmp.

[in] lMaxImages

O número máximo de arquivos de despejo que podem existir no diretório de despejo. Especificar essa variável impede que arquivos de despejo consumam muito espaço de armazenamento.

[out, retval] pbstrDumpFile

O nome do arquivo de despejo que contém a imagem resultante da instância do aplicativo.

Retornar valor

Esse método pode retornar os valores de retorno padrão E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED e E_FAIL, bem como os valores a seguir.

Código de retorno	Descrição
S_OK	O método foi concluído com sucesso.
COMADMIN_E_APP_NOT_RUNNING	O processo especificado não está em execução.

Requisitos

Requisito	Valor
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]
Plataforma de Destino	Windows
Cabeçalho	comadmin.h

Confira também

ICOMAdminCatalog2

Compartilhar via