función IStream_Size (shlwapi.h)

Recupera el tamaño, en bytes, de una secuencia especificada.

Sintaxis

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

Parámetros

[in] pstm

Tipo: IStream*

Puntero a la interfaz IStream de la secuencia cuyo tamaño se va a determinar.

[out] pui

Tipo: ULARGE_INTEGER*

Puntero a una estructura ULARGE_INTEGER para recibir el tamaño de la secuencia.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un código de error COM en caso contrario. Consulte IStream::Stat para obtener más información sobre los posibles códigos de error.

Comentarios

Esta función obtiene el tamaño de la secuencia llamando al método IStream::Stat del objeto de secuencia especificado. A continuación, copia el valor del miembro cbSize de la estructura STATSTG devuelta por IStream::Stat a la estructura de ULARGE_INTEGER a la que apunta pui. Si se produce un error en la función, el contenido de la estructura ULARGE_INTEGER no está definido.

Requisitos