Funzione StgCreatePropStg (coml2api.h)

Articolo
08/22/2023

La funzione StgCreatePropStg crea e apre una proprietà impostata in un oggetto di archiviazione o flusso specificato. Il set di proprietà fornisce l'implementazione autonoma del sistema dell'interfaccia IPropertyStorage .

Sintassi

HRESULT StgCreatePropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  const CLSID      *pclsid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

Parametri

[in] pUnk

Puntatore all'interfaccia IUnknown nell'oggetto di archiviazione o flusso che archivia il nuovo set di proprietà.

[in] fmtid

FmTID del set di proprietà da creare.

[in] pclsid

Puntatore al CLSID iniziale per questo set di proprietà. Può essere NULL, nel qual caso pclsid è impostato su tutti gli zero.

[in] grfFlags

I valori delle costanti PROPSETFLAG che determinano la modalità di creazione e apertura del set di proprietà.

[in] dwReserved

Riservati; deve essere zero.

[out] ppPropStg

Indirizzo di una variabile puntatore IPropertyStorage* che riceve il puntatore dell'interfaccia al nuovo set di proprietà.

Valore restituito

Questa funzione supporta i valori restituiti standard E_INVALIDARG e E_UNEXPECTED, oltre ai seguenti:

Commenti

StgCreatePropStg crea e apre un nuovo set di proprietà che fornisce l'implementazione autonoma del sistema dell'interfaccia IPropertyStorage . Il nuovo set di proprietà è contenuto nell'oggetto di archiviazione o flusso specificato da pUnk. Il valore del parametro grfFlags indica se pUnk specifica un oggetto di archiviazione o flusso. Ad esempio, se PROPSETFLAG_NONSIMPLE è impostato, pUnk può essere sottoposto a query per un'interfaccia IStorage in un oggetto di archiviazione.

In entrambi i casi, questa funzione chiama pUnk-AddRef> per l'oggetto di archiviazione o flusso contenente il set di proprietà. È responsabilità del chiamante rilasciare l'oggetto quando non è più necessario.

Questa funzione è simile al metodo IPropertySetStorage::Create . StgCreatePropStg aggiunge tuttavia il parametro pUnk e supporta il valore PROPSETFLAG_UNBUFFERED per il parametro grfFlags. Usare questa funzione anziché il metodo Create se si dispone di un'interfaccia IStorage che non supporta l'interfaccia IPropertySetStorage o se si vuole usare il valore di PROPSETFLAG_UNBUFFERED. Per altre informazioni sull'uso di questo valore di enumerazione PROPSETFLAG_UNBUFFERED, vedere Costanti PROPSETFLAG.

Il set di proprietà contiene automaticamente le proprietà della tabella codici e dell'identificatore delle impostazioni locali (ID). Questi sono impostati rispettivamente sul valore predefinito del sistema corrente e sul valore predefinito dell'utente corrente.

Il parametro grfFlags è una combinazione di valori presi dalle costanti PROPSETFLAG. Il nuovo valore di enumerazione PROPSETFLAG_UNBUFFERED è supportato. Per altre informazioni, vedere Costanti PROPSETFLAG.

Questa funzione viene esportata dall'Iprop.dll ridistribuibile, inclusa in Windows NT 4.0 con Service Pack 2 (SP2) e versioni successive e disponibili come ridistribuibile in Windows 95, Windows 98 e versioni successive. In Windows 2000 e Windows XP, viene esportato fuori ole32.dll. Può anche essere esportato fuori iprop.dll in Windows 2000 e Windows XP, ma la chiamata viene inoltrata a ole32.dll.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	coml2api.h (include Propidl.h)
Libreria	Ole32.lib
DLL	Ole32.dll