Método ICorDebugRemoteTarget::GetHostName

  • Artigo

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
[in] O tamanho, em caracteres, do buffer szHostName. 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. Este parâmetro pode ser nulo.

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

Valor Retornado

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

E_FAIL (ou outros códigos E_ return)
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

Confira também