ICorDebugRemoteTarget::GetHostName, méthode

Article
11/05/2024

Retourne le nom de domaine complet ou l’adresse IPv4 de l’ordinateur cible de débogage distant. IPV6 n’est pas pris en charge pour le moment.

Syntaxe

HRESULT GetHostName (
    [in] ULONG32      cchHostName,
    [out] ULONG32*    pcchHostName,
    [out, size_is(cchHostName), length_is(*pcchHostName)]
            WCHAR szHostName[]

Paramètres

cchHostName [in] Taille, en caractères, de la szHostName mémoire tampon. Si ce paramètre est égal à 0 (zéro), szHostName doit être null.

pcchHostName [out] Nombre de caractères, y compris un terminateur Null, dans le nom d’hôte ou l’adresse IP. Ce paramètre peut avoir la valeur Null.

szHostName [out] Mémoire tampon qui contient le nom d’hôte ou l’adresse IP.

Valeur de retour

S_OK Le nom d’hôte ou l’adresse IP a été retourné avec succès.

E_FAIL (ou d’autres codes de retour E_) Impossible de retourner le nom d’hôte ou l’adresse IP.

Notes

Cette méthode est implémentée par l’enregistreur de débogueur. Il doit suivre le paradigme d’appel multiple : lors du premier appel, l’appelant passe null à la fois à cchHostName et szHostName, et pcchHostName retourne la taille de la mémoire tampon requise. Lors du deuxième appel, la taille qui a été retournée précédemment est passée dans cchHostName et une mémoire tampon de taille appropriée est passée dans szHostName.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : CorDebug.idl

Bibliothèque : CorGuids.lib

Versions de .NET Framework : 3.5 SP1

Partager via