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

  • Artigo

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

Confira também

IInputPaneInterop

IInspectable

winrt::get_class_name