Método IDebugControl3::GetLogFile (dbgeng.h)

Artículo
02/23/2024

El método GetLogFile devuelve el nombre del archivo de registro abierto actualmente.

Sintaxis

HRESULT GetLogFile(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG FileSize,
  [out]           PBOOL  Append
);

Parámetros

[out, optional] Buffer

Recibe el nombre del archivo de registro abierto actualmente. Si El búfer es NULL, esta información no se devuelve.

[in] BufferSize

Especifica el tamaño, en caracteres, del búfer de búfer .

[out, optional] FileSize

Recibe el tamaño, en caracteres, del nombre del archivo de registro. Si FileSize es NULL, esta información no se devuelve.

[out] Append

Recibe TRUE si los mensajes de registro se anexan al archivo de registro o FALSE si el contenido del archivo de registro se descartaba cuando se abrió el archivo.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
S_FALSE	Método realizado correctamente. Sin embargo, el nombre del archivo de registro era demasiado largo para caber en el búfer de búfer para que el nombre se truncase.
E_NOINTERFACE	Actualmente no hay ningún archivo de registro abierto.

Comentarios

GetLogFile y GetLogFileWide se comportan del mismo modo que GetLogFile2 y GetLogFile2Wide con Append recibiendo solo la información sobre la marca de DEBUG_LOG_APPEND.

Para obtener más información sobre los archivos de registro, consulte Uso de entrada y salida.