IStoreNamespace::CreateFolder method

Creates a new message folder.

Syntax

HRESULT CreateFolder(
  [in]  STOREFOLDERID   dwParentId,
  [in]  LPCSTR          pszName,
  [in]  DWORD           dwReserved,
  [out] LPSTOREFOLDERID pdwFolderId
);

Parameters

dwParentId [in]

Type: STOREFOLDERID

Specifies the parent message folder that the created folder will be a child of.

pszName [in]

Type: LPCSTR

Specifies the new display name of the created folder.

dwReserved [in]

Type: DWORD

Reserved value. Must be 0.

pdwFolderId [out]

Type: LPSTOREFOLDERID

Pointer that receives the ID of the created folder.

Return value

Type: HRESULT

Returns S_OK if successful, or one of the following error values.

Return code	Description
E_INVALIDARG	The value of dwReserved is not 0, the value of dwParentId, is invalid, or the value of pszName or pdwFolderId is NULL.
MSOEAPI_E_STORE_INITIALIZE	The namespace has not been initialized. To initialize the namespace, call IStoreNamespace::Initialize.

Remarks

Each created folder must be a child of an existing parent folder that is not the root folder. If you specify a value of FOLDERID_ROOT in the dwParentId, the method will fail.

Requirements

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