ICorDebugRemoteTarget::GetHostName — Metoda

Zwraca w pełni kwalifikowaną nazwę domeny lub adres IPv4 maszyny docelowej debugowania zdalnego. 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 [in] 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ń: przy pierwszym wywołaniu obiekt wywołujący przekazuje wartość null zarówno do cchHostName , jak i szHostName, i pcchHostName zwraca rozmiar wymaganego buforu. W drugim wywołaniu rozmiar, który został wcześniej zwrócony, jest przekazywany w cchHostNameelemecie , a odpowiedni rozmiar buforu jest przekazywany w pliku szHostName.

Requirements

Platformy: Zobacz Obsługiwane systemy operacyjne platformy .NET.

Nagłówek: CorDebug.idl

Biblioteka: CorGuids.lib

Wersje platformy .NET: 3.5 z dodatkiem SP1

Zobacz także

• ICorDebugRemoteTarget, interfejs
• ICorDebug, interfejs