função IStream_Size (shlwapi.h)

Recupera o tamanho, em bytes, de um fluxo especificado.

Sintaxe

LWSTDAPI IStream_Size(
  [in]  IStream        *pstm,
  [out] ULARGE_INTEGER *pui
);

Parâmetros

[in] pstm

Tipo: IStream*

Um ponteiro para a interface IStream do fluxo cujo tamanho deve ser determinado.

[out] pui

Tipo: ULARGE_INTEGER*

Um ponteiro para uma estrutura ULARGE_INTEGER para receber o tamanho do fluxo.

Retornar valor

Tipo: HRESULT

Retorna S_OK em caso de êxito ou um código de falha COM caso contrário. Consulte IStream::Stat para obter mais discussões sobre possíveis códigos de erro.

Comentários

Essa função obtém o tamanho do fluxo chamando o método IStream::Stat do objeto de fluxo especificado. Em seguida, ele copia o valor do membro cbSize da estrutura STATSTG retornada por IStream::Stat para a estrutura ULARGE_INTEGER apontada por pui. Se a função falhar, o conteúdo da estrutura ULARGE_INTEGER será indefinido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server, Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shlwapi.h
DLL	Shlwapi.dll (versão 5.0 ou posterior)