Método IDebugControl4::OpenLogFile2 (dbgeng.h)

El método OpenLogFile2 abre un archivo de registro que recibirá la salida de los objetos de cliente.

Sintaxis

HRESULT OpenLogFile2(
  [in] PCSTR File,
  [in] ULONG Flags
);

Parámetros

[in] File

Especifica el nombre del archivo de registro. El archivo puede incluir una ruta de acceso relativa o absoluta; las rutas de acceso relativas son relativas al directorio en el que se inició el depurador. Si el archivo no existe, se creará.

[in] Flags

Especifica las marcas de bits que controlan la naturaleza del archivo de registro. Las marcas pueden contener marcas de la tabla siguiente.

Marca Efecto cuando se establece
DEBUG_LOG_APPEND La salida se anexará al archivo de registro en lugar de descartar el contenido del archivo de registro.
DEBUG_LOG_UNICODE El formato del archivo de registro será Unicode en lugar de ASCII.
 

Como alternativa, las marcas se pueden establecer en DEBUG_LOG_DEFAULT para el conjunto predeterminado de opciones que no contiene ninguna de las marcas.

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.

Comentarios

Solo se puede abrir un archivo de registro a la vez. Si ya hay un archivo de registro abierto, se cerrará.

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

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (include Dbgeng.h)

Consulte también

.logappend (Anexar archivo de registro)

.logopen (Abrir archivo de registro)

CloseLogFile

GetLogFile2

GetLogMask

IDebugControl4

OpenLogFile

SetLogMask