Método IWpfSettings::GetStringProperty

Recupera um valor de cadeia de caracteres das configurações do processo de trabalho ou do pool de aplicativos.

Sintaxe

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

Parâmetros

SettingId
[IN] Um valor WPF_SETTINGS_STRING_ENUM que especifica qual valor de cadeia de caracteres retornar.

pszSetting
[OUT] Um ponteiro para um buffer de cadeia de caracteres que recebe o valor especificado por SettingId.

pcchSetting
[IN] [OUT] Um ponteiro para um DWORD buffer que recebe o tamanho da cadeia de caracteres retornada em pszSetting.

Valor Retornado

Um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor	Descrição
S_OK	Indica que a operação foi bem-sucedida.
ERROR_INSUFFICIENT_BUFFER	Indica que não há espaço em buffer suficiente para executar a operação.
ERROR_INVALID_PARAMETER	Indica que o parâmetro especificado não é válido. (O parâmetro está fora do intervalo ou não é uma cadeia de caracteres.)

Comentários

Como o pszSetting parâmetro é opcional, ele pode ser NULL. Se o tamanho do valor da cadeia de caracteres exceder o tamanho especificado pelo pcchSetting parâmetro , o método retornará ERROR_INSUFFICIENT_BUFFER.

Requisitos

Type	Descrição
Cliente	– IIS 7.0 no Windows Vista – IIS 7.5 no Windows 7 – IIS 8.0 no Windows 8 – IIS 10.0 no Windows 10
Servidor	– IIS 7.0 no Windows Server 2008 – IIS 7.5 no Windows Server 2008 R2 – IIS 8.0 no Windows Server 2012 – IIS 8.5 no Windows Server 2012 R2 – IIS 10.0 no Windows Server 2016
Produto	- 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
parâmetro	Wpframework.h

Consulte Também

IWpfSettings Interface
Método IWpfSettings::GetBoolProperty
Método IWpfSettings::GetDwordProperty
Método IWpfSettings::GetHandleProperty
Método IWpfSettings::GetUlonglongProperty
Enumeração WPF_SETTINGS_STRING_ENUM