Função OleRegGetUserType (ole2.h)

  • Artigo

Obtém o tipo de usuário da classe especificada do registro.

Os desenvolvedores de aplicativos de objeto DLL personalizados usam essa função para emular o comportamento do manipulador padrão OLE.

Sintaxe

HRESULT OleRegGetUserType(
  [in]  REFCLSID clsid,
  [in]  DWORD    dwFormOfType,
  [out] LPOLESTR *pszUserType
);

Parâmetros

[in] clsid

O CLSID da classe para a qual o tipo de usuário deve ser solicitado.

[in] dwFormOfType

A forma da cadeia de caracteres apresentável pelo usuário. Os valores possíveis são obtidos da enumeração USERCLASSTYPE.

[out] pszUserType

Um ponteiro para uma cadeia de caracteres que recebe o tipo de usuário.

Retornar valor

Essa função pode retornar o valor retornado padrão E_OUTOFMEMORY, bem como os valores a seguir.

Código de retorno Descrição
S_OK
 O tipo de usuário foi retornado com êxito.
REGDB_E_CLASSNOTREG
 Nenhum CLSID está registrado para o objeto de classe.
REGDB_E_READREGDB
 Ocorreu um erro ao ler do registro.
OLE_E_REGDB_KEY
 As chaves ProgID = MainUserTypeName e CLSID = MainUserTypeName estão ausentes no Registro.

Comentários

Os aplicativos de objeto podem pedir ao OLE para obter o nome de tipo de usuário de uma classe especificada de uma das duas maneiras. Uma maneira é chamar OleRegGetUserType. A outra é retornar OLE_S_USEREG em resposta a chamadas do manipulador de objetos padrão para IOleObject::GetUserType. OLE_S_USEREG instrui o manipulador padrão a chamar OleRegGetUserType. Como os aplicativos de objeto DLL não podem retornar OLE_S_USEREG, eles devem chamar OleRegGetUserType, em vez de delegar o trabalho ao manipulador de objetos.

A função OleRegGetUserType e suas funções irmãos, OleRegGetMiscStatus, OleRegEnumFormatEtc e OleRegEnumVerbs, fornecem uma maneira para os desenvolvedores de aplicativos de objeto DLL personalizados emularem o comportamento do manipulador de objetos padrão do OLE na obtenção de informações sobre objetos do Registro. Usando essas funções, você evita o trabalho considerável de escrever suas próprias e as armadilhas inerentes ao trabalho diretamente no Registro. Além disso, você obtém aprimoramentos e otimizações futuros dessas funções sem precisar codiá-las por conta própria.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ole2.h
Biblioteca Ole32.lib
DLL Ole32.dll
Conjunto de APIs ext-ms-win-com-ole32-l1-1-3 (introduzido no Windows 10, versão 10.0.10240)

Confira também

IOleObject::GetUserType

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetMiscStatus