Compartir a través de


Implementación de archivos IEnumSTATPROPSTG-Compound

La implementación de archivo compuesto de la interfaz IEnumSTATPROPSTG se usa para enumerar propiedades, lo que da lugar a estructuras de 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.

Cuándo usar

Llame a la implementación de archivos compuestos de IEnumSTATPROPSTG para enumerar las estructuras de 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.

Observaciones

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 omitieron los elementos de celt; devuelve S_FALSE si se omitieron menos de 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 elIEnumSTATPROPSTG depara 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