Share via

Метод ICorDebugRemoteTarget::GetHostName

  • Статья

Возвращает полное доменное имя или IPv4-адрес целевого компьютера удаленной отладки. В настоящее время IPV6 не поддерживается.

Синтаксис

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

Параметры

cchHostName
[in] Размер буфера szHostName (в символах). Если этот параметр равен 0 (ноль), szHostName значение должно иметь значение NULL.

pcchHostName
[out] Число символов в имени узла или IP-адресе, включая признаки null. Этот параметр может быть нулевым.

szHostName
[out] Буфер, содержащий имя узла или IP-адрес.

Возвращаемое значение

S_OK
Имя узла или IP-адрес успешно возвращены.

E_FAIL (или другие коды возврата E_)
Не удается вернуть имя узла или IP-адрес.

Комментарии

Этот метод реализуется модулем записи отладчика. Он должен соответствовать парадигме нескольких вызовов: при первом вызове вызывающий объект передает значение NULL и cchHostNameszHostName, а pcchHostName затем возвращает размер требуемого буфера. Во втором вызове возвращенный ранее размер передается в cchHostName, а буфер соответствующего размера передается в szHostName.

Требования

Платформы: см. раздел Требования к системе.

Заголовка: CorDebug.idl

Библиотека: CorGuids.lib

платформа .NET Framework версии: 3.5 с пакетом обновления 1 (SP1)

См. также раздел