Metodo ICorDebugRemoteTarget::GetHostNameICorDebugRemoteTarget::GetHostName Method

Restituisce il nome di dominio completo o l'indirizzo IPv4 del computer di destinazione per il debug remoto.Returns the fully qualified domain name or IPv4 address of the remote debugging target machine. IPV6 non è attualmente supportato.IPV6 is not supported at this time.

SintassiSyntax

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

ParametriParameters

cchHostName
[in] La dimensione, in caratteri, del szHostName buffer.[in] The size, in characters, of the szHostName buffer. Se il parametro è 0 (zero), szHostName deve essere Null.If this parameter is 0 (zero), szHostName must be null.

pcchHostName
[out] Numero di caratteri, incluso un terminatore Null, nel nome host o nell'indirizzo IP.[out] The number of characters, including a null terminator, in the host name or IP address. Questo parametro può essere null.This parameter can be null.

szHostName
[out] Buffer contenente il nome host o l'indirizzo IP.[out] Buffer that contains the host name or IP address.

Valore restituitoReturn Value

S_OKS_OK
Il nome host o l'indirizzo IP è stato restituito correttamente.The host name or IP address was successfully returned.

E_FAIL (o altri codici E_ restituiti)E_FAIL (or other E_ return codes)
Impossibile restituire il nome host o l'indirizzo IP.Unable to return the host name or IP address.

NoteRemarks

Questo metodo viene implementato dal writer del debugger.This method is implemented by the debugger writer. 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.It must follow the multiple call paradigm: On the first call, the caller passes null to both cchHostName and szHostName, and pcchHostName returns the size of the required buffer . Nella seconda chiamata, la dimensione che è stata restituita in precedenza viene passata a cchHostName e un buffer di dimensioni appropriate viene passato a szHostName.On the second call, the size that was previously returned is passed in cchHostName, and an appropriately sized buffer is passed in szHostName.

RequisitiRequirements

Piattaforme: vedere requisiti di sistema.Platforms: See System Requirements.

Intestazione: Cordebug. idlHeader: CorDebug.idl

Libreria: CorGuids. libLibrary: CorGuids.lib

Versioni di .NET framework: 3.5 SP1.NET Framework Versions: 3.5 SP1

Vedere ancheSee Also

Interfaccia ICorDebugRemoteTargetICorDebugRemoteTarget Interface
Interfaccia ICorDebugICorDebug Interface