Funzione StgOpenPropStg (coml2api.h)

Articolo
08/22/2023

La funzione StgOpenPropStg apre un set di proprietà specificato in un oggetto di archiviazione o flusso specificato. Il set di proprietà fornisce l'implementazione autonoma fornita dal sistema dell'interfaccia IPropertyStorage .

Sintassi

HRESULT StgOpenPropStg(
  [in]  IUnknown         *pUnk,
  [in]  REFFMTID         fmtid,
  [in]  DWORD            grfFlags,
  [in]  DWORD            dwReserved,
  [out] IPropertyStorage **ppPropStg
);

Parametri

[in] pUnk

Puntatore di interfaccia per l'interfaccia IUnknown nell'oggetto di archiviazione o flusso che contiene l'oggetto set di proprietà richiesto.

[in] fmtid

FMTID della proprietà impostata per l'apertura.

[in] grfFlags

Valori delle costanti PROPSETFLAG.

[in] dwReserved

Riservato per utilizzi futuri; deve essere zero.

[out] ppPropStg

Puntatore a una variabile puntatore IPropertyStorage* che riceve il puntatore dell'interfaccia al set di proprietà richiesto.

Valore restituito

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

Commenti

StgOpenPropStg apre il set di proprietà richiesto e fornisce l'implementazione autonoma fornita dal sistema dell'interfaccia IPropertyStorage . Il set di proprietà richiesto è 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à. Il chiamante deve rilasciare l'oggetto quando non è più necessario.

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

Il parametro grfFlags è una combinazione di valori ricavati dalle costanti PROPSETFLAG. È supportato il nuovo valore di enumerazione PROPSETFLAG_UNBUFFERED. 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 disponibile come ridistribuibile in Windows 95 e versioni successive. In Windows 2000 viene esportato da Ole32.dll. Può anche essere esportato da iprop.dll in Windows 2000, 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