IXpsOMDictionary::GetAt method

Gets the IXpsOMShareable interface pointer and the key name string of the entry at a specified index in the dictionary.

Syntax

HRESULT GetAt(
  [in]          UINT32          index,
  [out]         LPWSTR          *key,
  [out, retval] IXpsOMShareable **entry
);

Parameters

  • index [in]
    The zero-based index of the dictionary entry that is to be obtained.

  • key [out]
    The key string that is found at the location specified by index.

  • entry [out, retval]
    The IXpsOMShareable interface pointer that is found at the location specified by index.

Return value

If the method succeeds, it returns S_OK; otherwise, it returns an HRESULT error code.

Remarks

The interface pointers that are stored in a dictionary will usually point to interfaces, such as IXpsOMBrush and IXpsOMVisual, that are derived from the IXpsOMShareable interface. To determine the interface type, call the IXpsOMShareable::GetType method.

This method allocates the memory used by the string that is returned in key. If key is not NULL, use the CoTaskMemFree function to free the memory.

Requirements

Minimum supported client

Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps | Windows Store apps]

Header

Xpsobjectmodel.h

IDL

XpsObjectModel.idl

See also

IXpsOMDictionary

IXpsOMShareable

IXpsOMBrush

IXpsOMVisual

XML Paper Specification