Previous in Contents Next in Contents

ISpecifyPropertyPages::GetPages

The GetPages method fills a counted array of universally unique identifier (UUID values where each UUID specifies the class identifier (CLSID) of a particular property page that can be displayed in the property sheet for this object.

The CAUUID structure is caller-allocated, but is not initialized by the caller. The ISpecifyPropertyPages::GetPages method fills the cElements field in the CAUUID structure. This method also allocates memory for the array pointed to by the pElems field in CAUUID using CoTaskMemAlloc. Then, it fills the newly allocated array. After this method returns successfully, the structure contains a counted array of UUIDs, each UUID specifying a property page CLSID.

Syntax

HRESULT GetPages(
CAUUID *pPages// out
);

Parameter

pPages
Pointer to a caller-allocated CAUUID structure that must be initialized and filled before returning. The pElems field in the CAUUID structure is allocated by the callee with CoTaskMemAlloc and freed by the caller with CoTaskMemFree.

\

Return Value

The method returns an HRESULT value.

Remarks

The CAUUID structure is defined as follows:

typedef struct tagCAUUID
{
ULONGcElems;
GUID FAR *pElems;
} CAUUID;

cElems
Size of the array pointed to by pElems.
pElems
Pointer to an array of UUID values, each of which specifies a CLSID of a particular property page. This array is allocated by the callee using CoTaskMemAlloc and is freed by the caller using CoTaskMemFree.

© 1997-2000 Microsoft Corporation. All rights reserved.