ICorProfilerInfo::GetAppDomainInfo-Methode

  • Artikel

Akzeptiert eine Anwendungsdomänen-ID. Gibt den Namen einer Anwendungsdomäne und die ID des Prozesses zurück, in dem diese enthalten ist.

Syntax

HRESULT GetAppDomainInfo(  
    [in]  AppDomainID appDomainId,  
    [in]  ULONG       cchName,  
    [out] ULONG       *pcchName,  
    [out, size_is(cchName), length_is(*pcchName)]  
          WCHAR       szName[] ,  
    [out] ProcessID   *pProcessId);

Parameter

appDomainId
[in] Die ID der Anwendungsdomäne.

cchName
[in] Die Länge des szName-Rückgabepuffers in Zeichen.

pcchName
[out] Ein Zeiger auf die Gesamtzeichenanzahl des Namens der Anwendungsdomäne.

szName
[out] Ein vom Aufrufer bereitgestellter Breitzeichenpuffer. Wenn die Methode abgeschlossen ist, enthält szName den vollständigen oder teilweisen Anwendungsdomänennamen.

pProcessId
[out] Ein Zeiger auf die ID Prozesses, der die Anwendungsdomäne enthält.

Bemerkungen

Nachdem diese Methode abgeschlossen ist, müssen Sie überprüfen, ob der szName-Puffer groß genug war, um den vollständigen Namen der Anwendungsdomäne aufzunehmen. Vergleichen Sie zu diesem Zweck den Wert, auf den pcchName verweist, mit dem Wert des Parameters cchName. Wenn pcchName auf einen Wert verweist, der größer als cchName ist, weisen Sie einen größeren szName-Puffer zu, aktualisieren Sie cchName mit der neuen Größe, und rufen Sie GetAppDomainInfo erneut auf.

Alternativ können Sie zuerst GetAppDomainInfo mit einem szName-Puffer der Länge 0 (NULL) aufrufen, um die richtige Puffergröße zu ermitteln. Sie können die Puffergröße dann auf den Wert festlegen, der von pcchName zurückgegeben wurde, und GetAppDomainInfo erneut aufrufen.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorProf.idl, CorProf.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: Seit 2.0 verfügbar.

Siehe auch