Méthode IDebugClient3 ::GetIdentity (dbgeng.h)

Article
02/26/2024

La méthode GetIdentity retourne une chaîne décrivant l’ordinateur et l’utilisateur que ce client représente.

Syntaxe

HRESULT GetIdentity(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG IdentitySize
);

Paramètres

[out, optional] Buffer

Spécifie la mémoire tampon à recevoir la chaîne. Si Buffer a la valeur NULL, ces informations ne sont pas retournées.

[in] BufferSize

Spécifie la taille de la mémoire tampon.

[out, optional] IdentitySize

Reçoit la taille de la chaîne. Si IdentitySize a la valeur NULL, ces informations ne sont pas retournées.

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 taille de la chaîne étant supérieure à la taille de la mémoire tampon, elle a été tronquée pour tenir dans la mémoire tampon.

Remarques

Le contenu spécifique de la chaîne varie selon le système d’exploitation. Si le client est connecté à distance, certaines informations réseau peuvent également être présentes.

Pour plus d’informations sur les objets clients, consultez Objets client.