IMimeMessageW::QueryPropW method

  • Article

[QueryPropW is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Returns the value of a property in the root header.

Syntax

HRESULT QueryPropW(
  [in] LPCWSTR pwszName,
  [in] LPCWSTR pwszCriteria,
  [in] boolean fSubString,
  [in] boolean fCaseSensitive
);

Parameters

pwszName [in]

Type: LPCWSTR

Specifies the property name or ID.

pwszCriteria [in]

Type: LPCWSTR

Specifies the string to compare the property to.

fSubString [in]

Type: boolean

Specifies whether pwszCriteria is a sub-string of the property.

Value Meaning
false
 pwszCriteria equals the value of the property.
true
 pwszCriteria is a sub-string of the property.

fCaseSensitive [in]

Type: boolean

Specifies whether the string comparison is case-sensitive.

Value Meaning
false
 The string comparison is case-insensitive.
true
 The string comparison is case-sensitive.

Return value

Type: HRESULT

Returns one of the following values.

Return code Description
S_OK
 Indicates that the values are equal.
S_FALSE
 Indicates that the values are not equal.
E_FAIL
 Indicates that an unknown error has occurred.
E_INVALIDARG
 Indicates that pwszName or pwszCriteria is NULL.
MIME_E_VARTYPE_NO_CONVERT
 Indicates that the value of the property specified by pwszName cannot be converted to a string.

Requirements
Minimum supported client
 Windows XP [desktop apps only]
Minimum supported server
 Windows Server 2003 [desktop apps only]
Product
 Outlook Express 6.0
Header
Mimeole.h
IDL
Mimeole.idl
DLL
Inetcomm.dll (version 6.0 or later)