Método ICorDebugRemoteTarget::GetHostName

Artigo
11/05/2024

Retorna o nome de domínio totalmente qualificado ou o endereço IPv4 da máquina de destino de depuração remota. IPV6 não é suportado 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 este parâmetro for 0 (zero), szHostName deve ser null.

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

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

Devolver Valor

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 endereço IP.

Observações

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

Requisitos

Plataformas: Consulte Requisitos do sistema.

Cabeçalho: CorDebug.idl

Biblioteca: CorGuids.lib

Versões do .NET Framework: 3.5 SP1

Partilhar via