ICorProfilerInfo11::GetEnvironmentVariable-Methode

Ruft eine Umgebungsvariable aus dem Prozess ab. Auf Nicht-Windows-Plattformen behält die Laufzeit einen internen Cache von Umgebungsvariablen bei, um die Threadsicherheit sicherzustellen. Dies bedeutet, dass beim Aufrufen getenv keine neuen oder aktualisierten Umgebungsvariablen gelesen werden, die nach dem Start durch verwalteten Code festgelegt werden.

Syntax

    HRESULT GetEnvironmentVariable(
                [in, string] const WCHAR *szName,
                [in]         ULONG cchValue,
                [out]        ULONG *pcchValue,
                [out, annotation("_Out_writes_to_(cchValue, *pcchValue)")]
                             WCHAR szValue[]);

Die Parameter

szName
[in] Ein Zeiger auf eine mit Null beendete breite Zeichenfolge mit dem Namen der Umgebungsvariablen, die abgerufen werden soll.

cchValue
[in] Die Länge (in Zeichen) von szValue.

pcchValue
[out] Ein Zeiger auf die Gesamtzeichenlänge von szValue.

szValue
[out] Ein Aufrufer hat einen breiten Zeichenpuffer bereitgestellt. Wenn die Funktion den Puffer zurückgibt, enthält sie den Wert der Umgebungsvariable.

Anforderungen

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Kopfball: CorProf.idl, CorProf.h

.NET-Versionen: Verfügbar seit .NET Core 3.1

Siehe auch

• ICorProfilerInfo11-Schnittstelle