StgMakeUniqueName, fonction (shlobj_core.h)

Crée un nom unique pour un flux ou un objet de stockage à partir d’un modèle.

Syntaxe

HRESULT StgMakeUniqueName(
  [in]  IStorage *pstgParent,
  [in]  PCWSTR   pszFileSpec,
  [in]  DWORD    grfMode,
  [in]  REFIID   riid,
  [out] void     **ppv
);

Paramètres

[in] pstgParent

Type : IStorage*

Pointeur vers un objet IStorage .

[in] pszFileSpec

Type : PCWSTR

Format ou modèle du nom du flux ou de l’objet de stockage.

[in] grfMode

Type : DWORD

Mode d’accès à utiliser lors de l’ouverture du flux ou de l’objet de stockage. Pour plus d’informations et pour obtenir des descriptions des valeurs possibles, consultez Constantes STGM.

[in] riid

Type : REFIID

Référence à l’IID de l’interface à récupérer via ppv, généralement IID_IStorage ou IID_IStream.

[out] ppv

Type : void**

Lorsque cette méthode est retournée, contient le pointeur d’interface demandé dans riid. Il s’agit généralement de IStorage ou IStream.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Il est recommandé d’utiliser la macro IID_PPV_ARGS , définie dans Objbase.h, pour empaqueter les paramètres riid et ppv . Cette macro fournit l’IID correct en fonction de l’interface pointée par la valeur dans ppv, ce qui élimine la possibilité d’une erreur de codage.

Configuration requise