Share via

ICorDebugRemoteTarget::GetHostName, méthode

  • Article

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 mémoire tampon szHostName. 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 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

Voir aussi