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

Article
02/26/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 La mémoire tampon 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 la valeur NULL, ces informations ne sont pas retournées.

[out] Append

Reçoit TRUE si les messages du 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 était trop long pour tenir dans la mémoire tampon de sorte que le nom a été tronqué.
E_NOINTERFACE	Aucun fichier journal n’est actuellement 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 d’entrée et de sortie.