Método IXpsOMDictionary::GetAt (xpsobjectmodel.h)

Obtém o ponteiro da interface IXpsOMShareable e a cadeia de caracteres de nome de chave da entrada em um índice especificado no dicionário.

Sintaxe

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

Parâmetros

[in] index

O índice baseado em zero da entrada de dicionário a ser obtida.

[out] key

A cadeia de caracteres de chave encontrada no local especificado pelo índice.

[out, retval] entry

O ponteiro da interface IXpsOMShareable encontrado no local especificado pelo índice.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK; caso contrário, ele retornará um código de erro HRESULT .

Comentários

Os ponteiros de interface armazenados em um dicionário geralmente apontarão para interfaces, como IXpsOMBrush e IXpsOMVisual, que são derivadas da interface IXpsOMShareable . Para determinar o tipo de interface, chame o método IXpsOMShareable::GetType .

Esse método aloca a memória usada pela cadeia de caracteres retornada na chave. Se key não for NULL, use a função CoTaskMemFree para liberar a memória.

Requisitos

Confira também

IXpsOMBrush

IXpsOMDictionary

IXpsOMShareable

IXpsOMVisual

Especificação de Papel XML