提供目前屬性的屬性驗證參數資訊。
語法
HRESULT get_ValidationParameter(
[out,
retval,
string] BSTR* pbstrValidationParameter
);
參數
pbstrValidationParameter
包含驗證參數的 指標 BSTR 。
傳回值
HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
| 值 | 描述 |
|---|---|
| S_OK | 表示作業成功。 |
備註
剖析 XML，以及 API 呼叫以設定組態系統中的值時，就會執行屬性驗證。
下表提供可用的驗證類型。
| 驗證類型 | 描述 |
|---|---|
| applicationPoolName | 如果屬性值包含下列任一個字元，驗證將會失敗： |<>&\"如果屬性值包含其中一個受限制的字元，下列範例將會導致驗證失敗。 validationType="applicationPoolName"validationParameter="" |
| integerRange | 語法： <minimum>,<maximum>[,exclude]如果屬性值設定為超出指定範圍的值，將會失敗驗證。 如果 屬性設定為小於 1 或大於 10 的值，下列範例將會導致驗證失敗。 validationType="integerRange"validationParameter="1,10,exclude" |
| nonEmptyString | 如果屬性值設定為空字串，驗證將會失敗。 如果屬性值設定為空字串，下列範例將會導致驗證失敗。 validationType="nonEmptyString"validationParameter="" |
| siteName | 如果屬性值包含下列任一個字元，驗證將會失敗： /\.?如果屬性值包含其中一個受限制的字元，下列範例將會導致驗證失敗。 validationType="siteName"validationParameter="" |
| timeSpanRange | 語法： <minimum>,<maximum>,<granularity>[,exclude]如果屬性值設定為超出指定範圍的值，將會失敗驗證。 <granularity>表示 和 <maximum> 之間 <minimum> 允許的遞增。如果屬性設定為小於 1、大於 2592000 的值，而且不是範圍內 60 的遞增，下列範例將會導致驗證失敗。 validationType="timeSpanRange"validationParameter="1,2592000,60" |
| requireTrimmedString | 如果在開頭或結束屬性值找到空白字元，將會失敗驗證。 如果屬性值在值的開頭或結尾包含空白字元，下列範例將會導致驗證失敗。 validationType="requireTrimmedString"validationParameter="" |
規格需求
| 類型 | 描述 |
|---|---|
| Client | - Windows Vista 上的 IIS 7.0 - Windows 7 上的 IIS 7.5 - Windows 8 上的 IIS 8.0 - Windows 10上的 IIS 10.0 |
| 伺服器 | - Windows Server 2008 上的 IIS 7.0 - Windows Server 2008 R2 上的 IIS 7.5 - Windows Server 2012 上的 IIS 8.0 - Windows Server 2012 R2 上的 IIS 8.5 - Windows Server 2016上的 IIS 10.0 |
| 產品 | - 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 |
| 標頭 | Ahadmin.h |
另請參閱
IAppHostPropertySchema 介面
IAppHostPropertySchema：：ValidationType 屬性