Implementación de archivos IEnumSTATPROPSTG-Compound

  • Artículo

La implementación de archivo compuesto de la interfaz IEnumSTATPROPSTG se usa para enumerar propiedades, lo que da lugar a estructuras STATPROPSTG , que contienen datos estadísticos de propiedad. La implementación de IPropertyStorage administra los datos estadísticos y está asociado a un objeto de almacenamiento de archivos compuesto actual.

El constructor de la implementación COM de IEnumSTATPROPSTG crea una clase que lee todo el conjunto de propiedades y crea una matriz estática que se puede compartir cuando se llama a IEnumSTATPROPSTG::Clone .

Casos en los que se debe usar

Llame a la implementación de archivo compuesto de IEnumSTATPROPSTG para enumerar las estructuras STATPROPSTG que contienen datos sobre las propiedades del conjunto de propiedades actual. Al usar la implementación de archivos compuestos de las interfaces de almacenamiento de propiedades, llame a IPropertyStorage::Enum para devolver un puntero a IEnumSTATPROPSTG para administrar el objeto de almacenamiento de propiedades y los elementos que contiene.

Comentarios

IEnumSTATPROPSTG::Next

Obtiene las siguientes estructuras STATPROPSTG (el número se especifica mediante el parámetro celt ). Devuelve S_OK si se ejecuta correctamente.

IEnumSTATPROPSTG::Skip

Omite el número de elementos especificados en celt. El siguiente elemento que se va a enumerar a través de una llamada a Next se convierte en el elemento después de los elementos omitidos. Devuelve S_OK si se omiten los elementos celt ; devuelve S_FALSE si se omiten menos elementos celt .

IEnumSTATPROPSTG::Reset

Establece el cursor al principio de la enumeración. Si se ejecuta correctamente, devuelve S_OK; de lo contrario, devuelve STG_E_INVALIDHANDLE.

IEnumSTATPROPSTG::Clone

Usa el constructor para IEnumSTATPROPSTG para crear una copia de la matriz. Dado que la clase que construye la matriz estática contiene realmente el objeto , esta función se agrega principalmente al recuento de referencias.

STATPROPSTG

IPropertyStorage::Enum