Funzione SHPropStgCreate (shlobj_core.h)

[Questa funzione è disponibile tramite Windows XP Service Pack 2 (SP2) e Windows Server 2003. Potrebbe essere modificato o non disponibile nelle versioni successive di Windows.]

Garantisce una corretta gestione del recupero o dell'assegnazione della tabella codici per l'operazione del set di proprietà richiesta.

Sintassi

SHSTDAPI SHPropStgCreate(
  [in]            IPropertySetStorage *psstg,
  [in]            REFFMTID            fmtid,
  [in, optional]  const CLSID         *pclsid,
                  DWORD               grfFlags,
                  DWORD               grfMode,
                  DWORD               dwDisposition,
  [out]           IPropertyStorage    **ppstg,
  [out, optional] UINT                *puCodePage
);

Parametri

[in] psstg

Tipo: IPropertySetStorage*

Puntatore a un'interfaccia IPropertySetStorage .

[in] fmtid

Tipo: REFFMTID

ID del set di proprietà da aprire. I valori per questo parametro possono essere uno di quelli definiti in Identificatori di formato set di proprietà predefinite o qualsiasi altro FMTID registrato.

[in, optional] pclsid

Tipo: const CLSID*

Puntatore al CLSID associato al set. Questo parametro può essere NULL.

grfFlags

Tipo: DWORD

Uno o più membri dell'enumerazione PROPSETFLAG che determinano la modalità di creazione e apertura del set di proprietà. Tutti i set contenenti byte ANSI devono essere creati con PROPSETFLAG_ANSI; in caso contrario, PROPSETFLAG_DEFAULT.

grfMode

Tipo: DWORD

Flag dell'enumerazione STGM che indicano le condizioni per la creazione e l'eliminazione dell'oggetto e delle modalità di accesso per l'oggetto. Deve contenere STGM_DIRECT | STGM_SHARE_EXCLUSIVE.

dwDisposition

Tipo: DWORD

Uno dei valori seguenti, definiti in Fileapi.h.

CREATE_NEW (1)

Creare un nuovo set se non ne esiste già uno.

CREATE_ALWAYS (2)

Creare sempre un nuovo set, sovrascrivendo qualsiasi set esistente.

OPEN_EXISTING (3)

Aprire il set esistente.

OPEN_ALWAYS (4)

[out] ppstg

Tipo: IPropertyStorage**

Quando termina, questo metodo contiene un puntatore all'interfaccia IPropertyStorage .

[out, optional] puCodePage

Tipo: UINT*

Quando termina, questo metodo contiene l'indirizzo dell'ID della tabella codici per il set.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj_core.h
Libreria	Shell32.lib
DLL	Shell32.dll (versione 6.0 o successiva)