Método ID2D1Properties::GetValueByName(PCWSTR,BYTE*,UINT32) (d2d1_1.h)

Obtém o valor da propriedade por nome.

Sintaxe

HRESULT GetValueByName(
  [in]  PCWSTR name,
  [out] BYTE   *data,
        UINT32 dataSize
);

[in] name

Tipo: PCWSTR

O nome da propriedade a ser obtido.

[out] data

Tipo: BYTE*

Quando esse método retorna, contém o buffer com o valor de dados.

dataSize

Tipo: UINT32

O número de bytes nos dados a serem recuperados.

Tipo: HRESULT

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

HRESULT	Descrição
S_OK	Não ocorreu nenhum erro.
D2DERR_INVALID_PROPERTY	A propriedade especificada não existe.
E_OUTOFMEMORY	Falha ao alocar a memória necessária.
D3DERR_OUT_OF_VIDEO_MEMORY	Falha ao alocar a memória de vídeo necessária.
E_INVALIDARG	Um ou mais argumentos são inválidos.
E_FAIL	Falha não especificada.

Se o nome não existir, nenhuma informação será recuperada.

Qualquer erro que não esteja no conjunto padrão retornado por uma implementação de propriedade será mapeado para o intervalo de erros padrão.


Cliente mínimo com suporte	Windows 8 e Platform Update para Windows 7 [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 e Platform Update para Windows Server 2008 R2 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	d2d1_1.h
Biblioteca	D2d1.lib
DLL	D2d1.dll