Método ICorDebugRemoteTarget::GetHostName

Artigo
11/05/2024

Retorna o nome de domínio totalmente qualificado ou o endereço IPv4 do computador alvo de depuração remota. Não há suporte para IPV6 no momento.

Sintaxe

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

Parâmetros

cchHostName [em] O tamanho, em caracteres, do szHostName buffer. Se esse parâmetro for 0 (zero), szHostName deverá ser nulo.

pcchHostName [fora] O número de caracteres, incluindo um terminador nulo, no nome do host ou endereço IP. Este parâmetro pode ser nulo.

szHostName [fora] Buffer que contém o nome do host ou o endereço IP.

Valor de retorno

S_OK O nome do host ou endereço IP foi retornado com êxito.

E_FAIL (ou outros códigos de retorno E_) Não é possível retornar o nome do host ou o endereço IP.

Comentários

Esse método é implementado pelo gravador do depurador. Ele deve seguir o paradigma de chamada múltipla: na primeira chamada, o chamador passa nulo para cchHostName e szHostName e pcchHostName retorna o tamanho do buffer necessário. Na segunda chamada, o tamanho retornado anteriormente é passado em cchHostName e um buffer de tamanho apropriado é passado em szHostName.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl

Biblioteca: CorGuids.lib

Versões do .NET Framework: 3.5 SP1

Compartilhar via