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.
Wymagania
Platformy: zobacz Wymagania systemowe.
Nagłówek: CorDebug.idl
Biblioteka: CorGuids.lib
Wersje programu .NET Framework: 3.5 z dodatkiem SP1
