Méthode IDebugControl ::GetLogFile (dbgeng.h)

Article
02/23/2024

La méthode GetLogFile retourne le nom du fichier journal actuellement ouvert.

Syntaxe

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

Paramètres

[out, optional] Buffer

Reçoit le nom du fichier journal actuellement ouvert. Si Buffer a la valeur NULL, ces informations ne sont pas retournées.

[in] BufferSize

Spécifie la taille, en caractères, de la mémoire tampon .

[out, optional] FileSize

Reçoit la taille, en caractères, du nom du fichier journal. Si FileSize a lavaleur NULL, ces informations ne sont pas retournées.

[out] Append

Reçoit TRUE si des messages de journal sont ajoutés au fichier journal, ou FALSE si le contenu du fichier journal a été ignoré lors de l’ouverture du fichier.

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.
S_FALSE	La méthode a réussi. Toutefois, le nom du fichier journal étant trop long pour tenir dans la mémoire tampon , le nom a été tronqué.
E_NOINTERFACE	Il n’existe actuellement aucun fichier journal ouvert.

Remarques

GetLogFile et GetLogFileWide se comportent de la même façon que GetLogFile2 et GetLogFile2Wide avec Append recevant uniquement les informations sur l’indicateur DEBUG_LOG_APPEND.

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