Метод ICorDebugRemoteTarget::GetHostName

Статья
11/05/2024

Возвращает полное доменное имя или 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] Число символов, включая конечный элемент NULL, в имени узла или IP-адресе. Этот параметр может быть нулевым.

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

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

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

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

Замечания

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

Требования

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

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

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

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

Поделиться через