Share via


IImnAccountManager::Enumerate method

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

Creates an IImnEnumAccounts object that allows a client to enumerate accounts that support specific servers.

Syntax

HRESULT Enumerate(
  [in]  DWORD            dwSrvTypes,
  [out] IImnEnumAccounts **ppEnumAccounts
);

Parameters

dwSrvTypes [in]

Type: DWORD

Specifies the server types to enumerate.

Value Meaning
SRV_NNTP
Indicates a NNTP server.
SRV_SMTP
Indicates a SMTP server.
SRV_POP3
Indicates a POP3 server.
SRV_IMAP
Indicates an IMAP server.
SRV_HTTPMAIL
Indicates an HTTPMail server.
SRV_LDAP
Indicates a LDAP server.

ppEnumAccounts [out]

Type: IImnEnumAccounts**

Receives the address of a pointer to the new IImnEnumAccounts object. The client is responsible for releasing this object.

Return value

Type: HRESULT

Returns one of the following values.

Return code Description
S_OK
Indicates success.
E_INVALIDARG
Indicates that ppEnumAccounts is NULL.
E_OUTOFMEMORY
Indicates that an attempt to allocate memory failed.
E_NoAccounts
Indicates that no accounts are configured.

Remarks

If a client needs to enumerate all accounts, pass in SRV_ALL for dwSrvTypes. The accounts are enumerated in sorted order by AP_ACCOUNT_NAME.

Requirements

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