IWpfSettings::GetStringProperty-Methode

Ruft einen Zeichenfolgenwert aus den Workerprozess- oder Anwendungspooleinstellungen ab.

Syntax

virtual HRESULT GetStringProperty(  
   IN WPF_SETTINGS_STRING_ENUM SettingId,  
   __out_ecount_opt(*pcchSetting) PWSTR pszSetting,  
   IN OUT DWORD* pcchSetting  
) = 0;  

Parameter

SettingId
[IN] Ein WPF_SETTINGS_STRING_ENUM Wert, der angibt, welcher Zeichenfolgenwert zurückgegeben werden soll.

pszSetting
[OUT] Ein Zeiger auf einen Zeichenfolgenpuffer, der den von SettingIdangegebenen Wert empfängt.

pcchSetting
[IN] [OUT] Ein Zeiger auf einen DWORD Puffer, der die Größe der in pszSettingzurückgegebenen Zeichenfolge empfängt.

Rückgabewert

HRESULT. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Wert	BESCHREIBUNG
S_OK	Gibt an, dass der Vorgang erfolgreich war.
ERROR_INSUFFICIENT_BUFFER	Gibt an, dass nicht genügend Pufferraum zum Ausführen des Vorgangs vorhanden ist.
ERROR_INVALID_PARAMETER	Gibt an, dass der angegebene Parameter ungültig ist. (Der Parameter ist entweder außerhalb des Bereichs oder keine Zeichenfolge.)

Bemerkungen

Da der pszSetting Parameter optional ist, kann er NULL sein. Wenn die Größe des Zeichenfolgenwerts die im pcchSetting Parameter angegebene Größe überschreitet, gibt die Methode ERROR_INSUFFICIENT_BUFFER zurück.

Anforderungen

type	BESCHREIBUNG
Client	– IIS 7.0 unter Windows Vista – IIS 7.5 unter Windows 7 – IIS 8.0 unter Windows 8 – IIS 10.0 auf Windows 10
Server	– IIS 7.0 unter Windows Server 2008 – IIS 7.5 unter Windows Server 2008 R2 – IIS 8.0 unter Windows Server 2012 – IIS 8.5 unter Windows Server 2012 R2 – IIS 10.0 auf Windows Server 2016
Produkt	– IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0 - IIS Express 7.5, IIS Express 8.0, IIS Express 10.0
Header	Wpframework.h

Weitere Informationen

IWpfSettings-Schnittstelle
IWpfSettings::GetBoolProperty-Methode
IWpfSettings::GetDwordProperty-Methode
IWpfSettings::GetHandleProperty-Methode
IWpfSettings::GetUlonglongProperty-Methode
WPF_SETTINGS_STRING_ENUM-Enumeration