Condividi tramite


Metodo ICorDebugRemoteTarget::GetHostName

Restituisce il nome di dominio completo o l'indirizzo IPv4 del computer di destinazione per il debug remoto. IPV6 non è attualmente supportato.

Sintassi

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

Parametri

cchHostName [in] Dimensione, in caratteri, del szHostName buffer. Se il parametro è 0 (zero), szHostName deve essere Null.

pcchHostName [out] Numero di caratteri, incluso un carattere di terminazione Null, nel nome host o nell'indirizzo IP. Questo parametro può essere null.

szHostName [out] Buffer che contiene il nome host o l'indirizzo IP.

Valore restituito

S_OK Il nome host o l'indirizzo IP è stato restituito correttamente.

E_FAIL (o altri codici restituiti di E_) Impossibile restituire il nome host o l'indirizzo IP.

Osservazioni:

Questo metodo viene implementato dal writer del debugger. Deve attenersi al paradigma di chiamate multiple: alla prima chiamata, il chiamante passa Null sia a cchHostName sia a szHostName e tramite pcchHostName viene restituita la dimensione del buffer richiesto. Nella seconda chiamata, la dimensione che è stata restituita in precedenza viene passata a cchHostName e un buffer di dimensioni appropriate viene passato a szHostName.

Requisiti

Piattaforme: vedere Requisiti di sistema.

Intestazione: CorDebug.idl

Libreria: CorGuids.lib

Versioni di .NET Framework: 3.5 SP1

Vedi anche