Método IInspectable::GetRuntimeClassName (inspectable.h)

Obtém o nome totalmente qualificado do objeto Windows Runtime atual.

Sintaxe

HRESULT GetRuntimeClassName(
  [out] HSTRING *className
);

Parâmetros

[out] className

Tipo: HSTRING*

O nome totalmente qualificado do objeto Windows Runtime atual.

Retornar valor

Tipo: HRESULT

Essa função pode retornar os valores a seguir.

Código de retorno	Descrição
S_OK	A cadeia de caracteres className foi criada com êxito.
E_OUTOFMEMORY	Falha ao alocar a cadeia de caracteres className .
E_ILLEGAL_METHOD_CALL	className refere-se a uma fábrica de classes ou a uma interface estática.

Comentários

Use o método GetRuntimeClassName para recuperar o nome qualificado do namespace de um objeto Windows Runtime.

O chamador é responsável por liberar a cadeia de caracteres className usando a função WindowsDeleteString .

A tabela a seguir mostra cadeias de caracteres de nome de classe de exemplo que podem ser retornadas pelo método GetRuntimeClassName .

Nome da classe de exemplo	Descrição
Fabrikam.Kitchen.IToaster	Uma interface no namespace Fabrikam.Kitchen.
Fabrikam.Kitchen.Chef	Uma classe no namespace Fabrikam.Kitchen.
Windows.Foundation.Collections.IVector'1<TailspinToys.IStore>	Um vetor de interfaces TailspinToys.IStore.
Windows.Foundation.Collections.IVector'1<Windows.Foundation.Collections.IMap'2<String, TailspinToys.IStore>>	Um vetor de mapas de cadeias de caracteres para interfaces TailspinToys.IStore.

O método GetRuntimeClassName fornece as informações de tipo mais específicas que o objeto de servidor garante que ele implemente. O nome do tipo pode ser um nome de classe de runtime, um nome de grupo de interface, um nome de interface ou um nome de interface parametrizado.

O método GetRuntimeClassName retornará E_ILLEGAL_METHOD_CALL se o nome da classe se referir a uma fábrica de classes ou a uma interface estática.

Requisitos


Cliente mínimo com suporte	Windows 8 [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2012 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	inspectable.h