ICorDebugRemoteTarget::GetHostName-Methode

Artikel
11/05/2024

Gibt den vollqualifizierten Domänennamen oder die IPv4-Adresse des Remotedebugging-Zielcomputers zurück. IPV6 wird zurzeit nicht unterstützt.

Syntax

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

Parameter

cchHostName [in] Die Größe des Puffers szHostName in Zeichen. Wenn dieser Parameter 0 (Null) ist, muss szHostName NULL sein.

pcchHostName [out] Die Anzahl der Zeichen, einschließlich eines Null-Terminators, im Hostnamen oder der IP-Adresse. Dieser Parameter kann NULL sein.

szHostName [out] Puffer, der den Hostnamen oder die IP-Adresse enthält.

Rückgabewert

S_OK Der Hostname oder die IP-Adresse wurde erfolgreich zurückgegeben.

E_FAIL (oder andere E_ Rückgabecodes) Kann den Hostnamen oder die IP-Adresse nicht zurückgeben.

Hinweise

Diese Methode wird vom Debugger-Writer implementiert. Sie muss dem Paradigma für mehrere Aufrufe entsprechen: Beim ersten Aufruf übergibt der Aufrufer sowohl cchHostName als auch szHostName, und pcchHostName gibt die Größe des erforderlichen Puffers zurück. Beim zweiten Aufruf wird die Größe, die zuvor zurückgegeben wurde, an cchHostName übergeben, und ein entsprechend skalierten Puffer wird an szHostName übergeben.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorDebug.idl

Bibliothek: CorGuids.lib

.NET Framework-Versionen: 3.5 SP1

Freigeben über