Share via


Méthode IDebugControl3 ::OpenLogFile (dbgeng.h)

La méthode OpenLogFile ouvre un fichier journal qui recevra la sortie des objets clients.

Syntaxe

HRESULT OpenLogFile(
  [in] PCSTR File,
  [in] BOOL  Append
);

Paramètres

[in] File

Spécifie le nom du fichier journal. Le fichier peut inclure un chemin d’accès relatif ou absolu ; les chemins relatifs sont relatifs au répertoire dans lequel le débogueur a été démarré. Si le fichier n'existe pas, il est créé.

[in] Append

Spécifie s’il faut ajouter ou non des messages de journal à un fichier journal existant. Si la valeur est TRUE, les messages de journal sont ajoutés au fichier ; Si la valeur est FALSE, le contenu de tout fichier correspondant existant file est ignoré.

Valeur retournée

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.

Code de retour Description
S_OK
La méthode a réussi.

Remarques

OpenLogFile et OpenLogFileWide se comportent de la même façon que OpenLogFile2 et OpenLogFile2Wide avec des indicateurs définis sur DEBUG_LOG_APPEND si Append a la valeur TRUE et DEBUG_LOG_DEFAULT sinon.

Un seul fichier journal peut être ouvert à la fois. S’il existe déjà un fichier journal ouvert, il sera fermé.

Pour plus d’informations sur les fichiers journaux, consultez Utilisation de l’entrée et de la sortie.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (inclure Dbgeng.h)

Voir aussi

.logappend (Ajouter un fichier journal)

.logopen (Ouvrir le fichier journal)

CloseLogFile

GetLogFile

GetLogMask

IDebugControl

IDebugControl2

IDebugControl3

OpenLogFile2

SetLogMask