Partager via


IWpfSettings::GetStringProperty, méthode

Récupère une valeur de chaîne à partir des paramètres du processus de travail ou du pool d’applications.

Syntaxe

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

Paramètres

SettingId
[IN] Valeur WPF_SETTINGS_STRING_ENUM qui spécifie la valeur de chaîne à retourner.

pszSetting
[OUT] Pointeur vers une mémoire tampon de chaîne qui reçoit la valeur spécifiée par SettingId.

pcchSetting
[IN] [OUT] Pointeur vers une DWORD mémoire tampon qui reçoit la taille de la chaîne retournée dans pszSetting.

Valeur renvoyée

Élément HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Valeur Description
S_OK Indique que l’opération a réussi.
ERROR_INSUFFICIENT_BUFFER Indique qu’il n’y a pas suffisamment d’espace tampon pour effectuer l’opération.
ERROR_INVALID_PARAMETER Indique que le paramètre spécifié n’est pas valide. (Le paramètre est hors limites ou n’est pas une chaîne.)

Remarques

Étant donné que le pszSetting paramètre est facultatif, il peut être NULL. Si la taille de la valeur de chaîne dépasse la taille spécifiée par le pcchSetting paramètre , la méthode retourne ERROR_INSUFFICIENT_BUFFER.

Spécifications

Type Description
Client - IIS 7.0 sur Windows Vista
- IIS 7.5 sur Windows 7
- IIS 8.0 sur Windows 8
- IIS 10.0 sur Windows 10
Serveur - IIS 7.0 sur Windows Server 2008
- IIS 7.5 sur Windows Server 2008 R2
- IIS 8.0 sur Windows Server 2012
- IIS 8.5 sur Windows Server 2012 R2
- IIS 10.0 sur Windows Server 2016
Produit - 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
En-tête Wpframework.h

Voir aussi

IWpfSettings, interface
IWpfSettings::GetBoolProperty, méthode
IWpfSettings::GetDwordProperty, méthode
IWpfSettings::GetHandleProperty, méthode
IWpfSettings::GetUlonglongProperty, méthode
WPF_SETTINGS_STRING_ENUM, énumération