Função OleRegGetUserType (ole2.h)
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 |
|---|---|
|
O tipo de usuário foi retornado com êxito. |
|
Nenhum CLSID está registrado para o objeto de classe. |
|
Ocorreu um erro ao ler do registro. |
|
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) |