Compartilhar via


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

Obtém o ponteiro da interface IXpsOMShareable da entrada que contém a chave especificada.

Sintaxe

HRESULT GetByKey(
  [in]          LPCWSTR         key,
  [in]          IXpsOMShareable *beforeEntry,
  [out, retval] IXpsOMShareable **entry
);

Parâmetros

[in] key

A chave da entrada a ser encontrada no dicionário.

[in] beforeEntry

O ponteiro da interface IXpsOMShareable para a última entrada no dicionário que deve ser pesquisada por chave. Se beforeEntry for NULL ou for um ponteiro de interface para uma entrada que não esteja no dicionário, todo o dicionário será pesquisado.

[out, retval] entry

O ponteiro de interface para a entrada do dicionário cuja chave corresponde à chave.

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 apontam 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 .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho xpsobjectmodel.h

Confira também

IXpsOMDictionary

IXpsOMShareable

Especificação de Papel XML