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 cchHostName
obiekcie , a w pliku jest przekazywany szHostName
odpowiedni bufor o rozmiarze .
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: CorDebug.idl
Biblioteki: CorGuids.lib
.NET Framework wersje: 3.5 SP1