Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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
-
Obtiene las siguientes estructuras STATPROPSTG (el número se especifica mediante el parámetro celt). Devuelve S_OK si se ejecuta correctamente.
-
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.
-
Establece el cursor al principio de la enumeración. Si se ejecuta correctamente, devuelve S_OK; de lo contrario, devuelve STG_E_INVALIDHANDLE.
-
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.
Temas relacionados