IHTTPMailTransport::CommandPROPFIND method

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

Sends the PROPFIND command to the HTTPMail server.

Syntax

C++
HRESULT CommandPROPFIND(
  [in] LPCSTR           pszPath,
  [in] IPropFindRequest *pRequest,
  [in] DWORD            dwDepth,
  [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.

pRequest [in]

Type: IPropFindRequest*

Specifies the property request object.

dwDepth [in]

Type: DWORD

Specifies the depth of request.

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.

dwContext [in]

Type: DWORD

Currently unused. Should be set to zero.

Return value

Type: HRESULT

Returns the following values.

Return code Description
S_OK
Indicates success.
E_INVALIDARG
Indicates that pszPath or pRequest 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)