Função ReadFmtUserTypeStg (ole2.h)

  • Artigo

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

Confira também

Cotaskmemfree

WriteFmtUserTypeStg