IOleObject::GetUserType
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Thismethod recupera o nome tipo usuário de um objeto para exibir elementos interface do usuário such as menus, caixas lista e diálogo caixas.
Syntax
HRESULT GetUserType(
DWORD dwFormOfType,
LPOLESTR* pszUserType
);
Parameters
dwFormOfType
[no] Especifica a forma do usuário-nome tipo a ser apresentado aos usuários.Os valores válidos são obtidos a partir de USERCLASSTYPE enumeração.
pszUserType
[out] Endereço do LPOLESTR ponteiro variável que recebe um ponteiro para o seqüência de caracteres tipo usuário.O chamador deve livre *pszUserType Usando o atual IMalloccerefIMalloc instância.
Se ocorrer um erro, a implementação deve definir *pszUserType para NULL.
Return Value
Um dos valores na seguinte tabela é retornada.
| Valor | Descrição |
|---|---|
S_OK |
Usuário do objeto-tipo nome é retornado. |
OLE_S_USEREG |
Delegar a implementação do manipulador de usar como padrão usar o Registro para fornecer as informações solicitadas. |
Remarks
Chamar recipientes GetUserType Para representar incorporado objetos no diálogo, menus e caixas lista caixas pelos seus nomes normais, usuário-reconhecível. Exemplos incluem "documento Word", "Excel gráfico" e "objeto Paintbrush".
As informações retornadas por GetUserType é o equivalente User-Readable do binário classe identificador retornado por IOleObject::GetUserClassID.
Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.
Notas para chamadores
Implementação do manipulador de usar como padrão de GetUserType Usa classe identificador do objeto (o pClsid parâmetro retornado por GetUserClassID) e o dwFormOfType parâmetro juntos como uma chave para o Registro.
Se for encontrada uma entrada que corresponda exatamente a chave, o tipo usuário especificado por essa entrada será retornado.
Se somente a parte CLSID a chave corresponde, a entrada lowest-numbered disponível (geralmente o nome completo) é usado.
Se o CLSID não é encontrado, ou há tipos nenhum usuário estão registrados para a classe, o tipo usuário encontrado no armazenamento do objeto será usado.
Fazer Não armazenar em cache que o seqüência de caracteres retornado da GetUserType. Em vez disso, chamar este método cada tempo de seqüência de caracteres é necessária. Isso garante os resultados corretos quando o objeto incorporado está sendo convertido de um tipo para outro sem conhecimento do chamador. Chamar esse método é barata porque o manipulador usar como padrão implementa-lo usando o Registro.
Notas para Implementers
Você pode usar a implementação fornecida pelo manipulador de usar como padrão retornando OLE_S_USEREG como implementação de seu aplicativo deste método.
Se o nome tipo usuário for um seqüência vazia, a mensagem "Unknown Object" será retornado.
Requirements
| Header | Oleidl.h, oleidl.idl |
| Library | oleaut32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
IOleObject
IMalloc
IOleObject::GetUserClassID