StgMakeUniqueName, fonction (shlobj_core.h)

Article
08/26/2023

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

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h (inclure Shlobj.h)
Bibliothèque	Shell32.lib
DLL	Shell32.dll (version 6.1 ou ultérieure)

Partager via