ICorProfilerInfo::GetAppDomainInfo-Methode

Artikel
09/02/2008

Aktualisiert: November 2007

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

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 Anwendungsdomänennamens.
szName
[out] Ein vom Aufrufer bereitgestellter Breitzeichenpuffer. Nach der Methodenrückgabe enthält szName den vollständigen oder teilweisen Anwendungsdomänennamen.
pProcessId
[out] Ein Zeiger auf die ID des Prozesses, der die Anwendungsdomäne enthält.

Hinweise

Nach der Methodenrückgabe müssen Sie überprüfen, ob der szName-Puffer groß genug war, um den vollständigen Namen der Anwendungsdomäne aufzunehmen. Vergleichen Sie hierzu den Wert, auf den pcchName verweist, mit dem Wert des cchName-Parameters. 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.

Sie können auch zunächst GetAppDomainInfo mit einem szName-Puffer der Größe 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 erneut GetAppDomainInfo aufrufen.

Weitere Informationen über diese beiden Ansätze finden Sie unter Vom Aufrufer reservierte Puffer.