Função ReadFmtUserTypeStg (ole2.h)
A função ReadFmtUserTypeStg retorna o formato da área de transferência e o tipo de usuário salvos anteriormente com a função WriteFmtUserTypeStg .
Sintaxe
HRESULT ReadFmtUserTypeStg(
[in] LPSTORAGE pstg,
[out] CLIPFORMAT *pcf,
[out] LPOLESTR *lplpszUserType
);
Parâmetros
[in] pstg
Ponteiro para a interface IStorage no objeto de armazenamento do qual as informações devem ser lidas.
[out] pcf
Ponteiro para onde o formato da área de transferência deve ser gravado no retorno. Pode ser NULL, indicando que o formato não é de interesse do chamador.
[out] lplpszUserType
Endereço da variável de ponteiro LPWSTR que recebe um ponteiro para a cadeia de caracteres do tipo de usuário Unicode terminada em nulo. O chamador pode especificar NULL para esse parâmetro, o que indica que o tipo de usuário não tem interesse. Essa função aloca memória para a cadeia de caracteres. O chamador é responsável por liberar a memória com CoTaskMemFree.
Retornar valor
Essa função dá suporte aos valores de retorno padrão E_FAIL, E_INVALIDARG e E_OUTOFMEMORY, além dos seguintes:
Essa função também retorna qualquer um dos valores de erro retornados pelo método ISequentialStream::Read .
Comentários
ReadFmtUserTypeStg retorna o formato da área de transferência e a cadeia de caracteres de tipo de usuário do objeto de armazenamento especificado. A função WriteClassStg deve ter sido chamada antes de chamar a função ReadFmtUserTypeStg .
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 |