Método IPropertySetStorage::Create (propidl.h)

Artículo
03/13/2024

El método Create crea y abre una nueva propiedad establecida en el objeto de almacenamiento del conjunto de propiedades.

Sintaxis

HRESULT Create(
  [in]  REFFMTID         rfmtid,
  [in]  const CLSID      *pclsid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            grfMode,
  [out] IPropertyStorage **ppprstg
);

Parámetros

[in] rfmtid

FMTID del conjunto de propiedades que se va a crear. Para obtener información sobre fmtiD que son conocidos y predefinidos en el SDK de plataforma, consulte Identificadores de formato de conjunto de propiedades predefinidos.

[in] pclsid

Puntero al CLSID del identificador de clase inicial para este conjunto de propiedades. Puede ser NULL, en cuyo caso se establece en todos los ceros. CLSID es el CLSID de una clase que muestra o proporciona acceso mediante programación a los valores de propiedad. Si no hay ninguna clase de este tipo, se recomienda usar el FMTID.

[in] grfFlags

Valores de constantes PROPSETFLAG.

[in] grfMode

Modo de acceso en el que se abrirá el conjunto de propiedades recién creado, tomado de ciertos valores de STGM_Constants, tal y como se describe en la sección Comentarios siguiente.

[out] ppprstg

Puntero a la variable de salida que recibe el puntero de interfaz IPropertyStorage .

Valor devuelto

Este método admite el valor devuelto estándar E_UNEXPECTED, así como lo siguiente:

Comentarios

IPropertySetStorage::Create crea y abre un nuevo subobjeto de conjunto de propiedades (compatible con la interfaz IPropertyStorage ) contenido en este objeto de almacenamiento del conjunto de propiedades. El conjunto de propiedades contiene automáticamente las propiedades de página de códigos y identificador de configuración regional. Se establecen en Unicode y el valor predeterminado del usuario actual, respectivamente.

El parámetro grfFlags es una combinación de valores tomados de las constantes PROPSETFLAG. Si se usa el valor PROPSETFLAG_ANSI de esta enumeración, la página de códigos se establece en el valor predeterminado del sistema actual, en lugar de Unicode.

El parámetro grfMode especifica el modo de acceso en el que se abrirá el conjunto recién creado. Los valores de este parámetro son como en el parámetro grfMode de IPropertySetStorage::Open, con la adición de los valores enumerados en la tabla siguiente.

Valor	Significado
STGM_FAILIFTHERE	Si existe otra propiedad establecida con el parámetro fmtid especificado, se produce un error en la llamada. Esta es la acción predeterminada; es decir, a menos que se especifique STGM_CREATE, STGM_FAILIFTHERE está implícito.
STGM_CREATE	Si ya existe otra propiedad establecida con el parámetro fmtid especificado, se quita y se reemplaza por esta nueva.

El conjunto de propiedades creado es sencillo de forma predeterminada, pero el autor de la llamada puede solicitar un conjunto de propiedades nomple especificando el valor PROPSETFLAG_NONSIMPLE en el parámetro grfFlags . Para obtener más información sobre los conjuntos de propiedades simples y nomples, vea Storage and Stream Objects for a Property Set.

Este método está sujeto a las restricciones del IStorage::CreateStream subyacente (para conjuntos de propiedades simples) o IStorage::CreateStorage (para conjuntos de propiedades nomple). Por ejemplo, al usar la implementación IPropertySetStorage-Compound File, especifique STGM_SHARE_EXCLUSIVE en el parámetro grfMode en IPropertySetStorage::Create. Por el contrario, si usa la implementación independiente de IPropertySetStorage,IPropertySetStorage::Create está sujeto a restricciones que se aplican al IStorage especificado por el autor de la llamada.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	propidl.h (include Objbase.h)
Library	Uuid.lib
Archivo DLL	Ole32.dll