StgCreatePropSetStg, fonction (coml2api.h)
La fonction StgCreatePropSetStg crée un objet de stockage de jeu de propriétés à partir d’un objet de stockage spécifié. L’objet de stockage du jeu de propriétés fournit l’implémentation autonome fournie par le système de l’interface IPropertySetStorage .
Syntaxe
HRESULT StgCreatePropSetStg(
[in] IStorage *pStorage,
DWORD dwReserved,
[out] IPropertySetStorage **ppPropSetStg
);
Paramètres
[in] pStorage
Pointeur vers l’objet de stockage qui contient ou contiendra un ou plusieurs jeux de propriétés.
dwReserved
Réservé pour une future utilisation ; doit être nul.
[out] ppPropSetStg
Pointeur vers la variable de pointeur IPropertySetStorage* qui reçoit le pointeur d’interface vers l’objet de stockage de jeu de propriétés.
Valeur retournée
Cette fonction prend en charge la valeur de retour standard E_INVALIDARG ainsi que les éléments suivants :
Remarques
La fonction StgCreatePropSetStg crée une interface IPropertySetStorage qui agit sur l’interface IStorage spécifiée par le paramètre pStorage . Cette fonction ne modifie pas cet IStorage d’elle-même, bien que les appels suivants à l’interface IPropertySetStorage puissent le faire.
StgCreatePropSetStg appelle IUnknown ::AddRef sur l’objet de stockage spécifié par pStorage. L’appelant doit libérer l’objet lorsqu’il n’est plus nécessaire en appelant Release.
Exemples
L’exemple de code suivant montre comment cette fonction crée un jeu de propriétés dans un objet de stockage.
IPropertyStorage*
CreatePropertySetInStorage( IStorage *pStg, const FMTID &fmtid )
{
HRESULT hr = S_OK;
IPropertySetStorage *pPropSetStg = NULL;
IPropertyStorage *pPropStg = NULL;
try
{
hr = StgCreatePropSetStg( pStg, 0, &pPropSetStg );
if( FAILED(hr) ) throw L"Failed StgCreatePropSetStg (%08x)";
hr = pPropSetStg->Create( fmtid, NULL,
PROPSETFLAG_DEFAULT,
STGM_CREATE | STGM_READWRITE | STGM_SHARE_EXCLUSIVE,
&pPropStg );
if( FAILED(hr) )
throw L"Failed IPropertySetStorage::Create (%08x)";
// Success. The caller must now call Release on both
// pPropSetStg and pStg.
}
catch( const WCHAR *pwszError )
{
wprintf( L"Error: %s (%08x)\n", pwszError, hr );
}
if( NULL != pPropSetStg )
pPropSetStg->Release();
return( pPropStg );
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau | Applications UWP] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | coml2api.h (include Propidl.h) |
| Bibliothèque | Ole32.lib |
| DLL | Ole32.dll |