IHTTPMailTransport::MemberInfo method

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

Returns properties for the specified resource.

Syntax

HRESULT MemberInfo(
  [in] LPCSTR          pszPath,
  [in] MEMBERINFOFLAGS flags,
  [in] DWORD           dwDepth,
  [in] BOOL            fIncludeRoot,
  [in] DWORD           dwContext
);

Parameters

pszPath [in]

Type: LPCSTR

Specifies an LPCSTR that contains a null-terminated string that is the complete URL to the resource.

flags [in]

Type: MEMBERINFOFLAGS

Specifies MEMBERINFOFLAGS values that indicate which properties should be requested for the resource specified by pszPath.

dwDepth [in]

Type: DWORD

Specifies a DWORD that indicates the value of the DEPTH request header.

Value	Meaning
0	Apply only to the specified resource.
1	Apply to the specified resource and its children.
DEPTH_INFINITY 0xFFFFFFFE	Apply to the specified resource and to all descendants.

fIncludeRoot [in]

Type: BOOL

Specifies a BOOL that indicates whether to exclude the resource and apply the command only to its childen by including the "noroot" token in the DEPTH header. If dwDepth is 0 then this parameter must be FALSE.

Value	Meaning
FALSE	Do not include the "noroot" token in the DEPTH header.
TRUE	Include the "noroot" token in the DEPTH header.

dwContext [in]

Type: DWORD

Currently unused. Should be set to zero.

Return value

Type: HRESULT

Returns one of the following values.

Return code	Description
S_OK	Indicates success.
E_INVALIDARG	Indicates that pszPath is NULL.
E_OUTOFMEMORY	Indicates that an attempt to allocate memory failed.

Requirements

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