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
);
Parâmetros
[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.
Valor retornado
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. |
Comentários
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.
Requisitos
| 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 |