ITSEnvClass::Value-Eigenschaft

In Configuration Manager enthält die Value Eigenschaft den Wert einer Tasksequenz-Umgebungsvariablen für die Betriebssystembereitstellung.

Syntax

[IDL]
HRESULT Value([in] BSTR Name, [in] BSTR Value);

HRESULT Value([in] BSTR Name, [out,retval] BSTR* Value);

Parameter

Name Datentyp: BSTR

Qualifikanten: [in]

Der Name der Umgebungsvariablen.

Value Datentyp: BSTR

Qualifikanten: [in; out, retval]

Bei Eingabe der Wert, der für die Umgebungsvariable festgelegt werden soll. Bei der Ausgabe zeigt dieser Parameter auf den Wert, der für den angegebenen Namen abgerufen wird.

Rückgabewerte

Ein HRESULT Code. Mögliche Werte sind unter anderem der folgende Wert.

S_OK Die Methode war erfolgreich.

Hinweise

Die Funktion ist erfolgreich mit S_OK, wenn sie get_Value mit einem ungültigen Variablennamen aufgerufen wird, ruft aber eine leere Zeichenfolge für den Wert ab. Dieses Verhalten unterscheidet sich von der häufigeren Rückgabe eines Exitcodes ungleich null, um eine ungültige Eingabe eines Variablennamens anzuzeigen.

Siehe auch

ITSEnvClass-Schnittstelle