Método ICorDebugRemoteTarget::GetHostName

Retorna o nome de domínio totalmente qualificado ou o endereço IPv4 do computador de destino 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 [in] O tamanho, em caracteres, do szHostName buffer. Se esse parâmetro for 0 (zero), szHostName deverá ser nulo.

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

szHostName [out] 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.

Observações

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

Requirements

Plataformas: Consulte sistemas operacionais com suporte do .NET.

Cabeçalho: CorDebug.idl

Biblioteca: CorGuids.lib

Versões do .NET: 3.5 SP1

Consulte também

• ICorDebugRemoteTarget Interface
• ICorDebug Interface