INNTPTransport::CommandHEAD method

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

Retrieves just the header for the requested article. If the caller has previously issued a GROUP command, then the article can be specified by either article number or message-id. Otherwise, the article must be requested by message-id. The provided stream will be filled and returned to the caller in OnResponse.

Syntax

HRESULT CommandHEAD(
  [in] LPARTICLEID pArticleId
);

Parameters

pArticleId [in]

Type: LPARTICLEID

Structure specifying the article to retrieve the header for.

Return value

Type: HRESULT

Returns one of the following values.

Return code Description
E_INVALIDARG
An invalid parameter was passed in
E_OUTOFMEMORY
A memory allocation 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)