Udostępnij za pośrednictwem


ICorDebugRemoteTarget::GetHostName — Metoda

Zwraca w pełni kwalifikowaną nazwę domeny lub adres IPv4 zdalnej maszyny docelowej debugowania. Protokół IPV6 nie jest obecnie obsługiwany.

Składnia

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

Parametry

cchHostName
[w] Rozmiar buforu szHostName , w postaci znaków. Jeśli ten parametr ma wartość 0 (zero), szHostName musi mieć wartość null.

pcchHostName
[out] Liczba znaków, w tym terminator o wartości null, w nazwie hosta lub adresie IP. Ten parametr może mieć wartość null.

szHostName
[out] Bufor zawierający nazwę hosta lub adres IP.

Wartość zwracana

S_OK
Nazwa hosta lub adres IP został pomyślnie zwrócony.

E_FAIL (lub inne kody powrotne E_)
Nie można zwrócić nazwy hosta lub adresu IP.

Uwagi

Ta metoda jest implementowana przez składnik zapisywania debugera. Musi on być zgodny z wieloma paradygmatami wywołań: w pierwszym wywołaniu obiekt wywołujący przekazuje wartość null zarówno cchHostName do , jak i szHostName, i pcchHostName zwraca rozmiar wymaganego buforu. Podczas drugiego wywołania rozmiar, który został wcześniej zwrócony, jest przekazywany w cchHostNameobiekcie , a w pliku jest przekazywany szHostNameodpowiedni bufor o rozmiarze .

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: CorDebug.idl

Biblioteki: CorGuids.lib

.NET Framework wersje: 3.5 SP1

Zobacz też