GetPropertyValue

 

Queries the specified property of the IIS version.

Syntax

HRESULT
GetPropertyValue(
    [in, string]  BSTR bstrName,
    [out, retval] VARIANT * pvarValue
);

Parameters

• [in, string] BSTR bstrName

  The name of the property to retrieve (case sensitive). The set of valid property names can be obtained by calling the function with the name availableReadableProperties as the bstrName parameter, which returns a comma-delimited BSTR. The following are the property names that are valid for all IIISVersion objects:

  • version. The version of the product in major.minor format.

  • productType. The product type, defined in the IIS_PRODUCT_TYPE enumeration, as a DWORD value (VARIANT I4).

  • installPath. The full path to the install location of the product.

  • defaultConfigurationPath. The default path to the configuration directory. For IIS Express, this path is calculated according the standard location of the user’s configuration directory, which differs by user. The result does not verify the existence of the directory or any files in it.

  • defaultSchemaPath. The default path to the schema file location.

  • manifestFile. The name of the Fusion manifest file for the product. The result can be an empty string if no manifest file exists.

• [out, retval] VARIANT * pvarValue

  The value of the property specified by bstrName.

Return Value

HRESULT

Exceptions

Exception

Condition

Remarks

The following IIISVersion objects can be used only for the IIS Express product type:

• userInstanceHelper. An IIISUserData object.

• expressProcessHelper. An IIISExpressProcessUtility object.

See Also

CreateObjectFromProgId
CreateObjectFromCLSID
ApplyIISEnvironmentVariables
ClearIISEnvironmentVariables
ApplyManifestContext
ClearManifestContext