IAppPublisher::EnumApps method (shappmgr.h)

Article
10/13/2021

Creates an enumerator for enumerating all applications published by an application publisher for a given category.

Syntax

HRESULT EnumApps(
  [in]  GUID               *pAppCategoryId,
  [out] IEnumPublishedApps **ppepa
);

Parameters

[in] pAppCategoryId

Type: GUID*

A pointer to a GUID that specifies the application category to be enumerated. This must be one of the categories provided through IAppPublisher::GetCategories. If pAppCategoryID identifies a category not provided through IAppPublisher::GetCategories, creation of the enumerator succeeds with the enumerator returning zero items. If this parameter value is NULL, the enumerator returns applications published for all categories.

[out] ppepa

Type: IEnumPublishedApps**

The address of a pointer to an IEnumPublishedApps reference variable that points to a IEnumPublishedApps interface. Application publishers must create an enumeration object that supports the IEnumPublishedApps interface, and return its pointer value through this parameter.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

Note IEnumPublishedApps is not a standard enumeration interface. It does not support a Skip method nor does its Next method support retrieval of multiple items.

Requirements

Requirement	Value
Minimum supported client	Windows XP, Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	shappmgr.h