Funzione StgMakeUniqueName (shlobj_core.h)

Articolo
03/02/2024

Crea un nome univoco per un flusso o un oggetto di archiviazione da un modello.

Sintassi

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

Parametri

[in] pstgParent

Tipo: IStorage*

Puntatore a un oggetto IStorage .

[in] pszFileSpec

Tipo: PCWSTR

Formato o modello per il nome del flusso o dell'oggetto di archiviazione.

[in] grfMode

Tipo: DWORD

Modalità di accesso da utilizzare quando si apre il flusso o l'oggetto di archiviazione. Per altre informazioni e descrizioni dei valori possibili, vedere Costanti STGM.

[in] riid

Tipo: REFIID

Riferimento all'IID dell'interfaccia da recuperare tramite ppv, in genere IID_IStorage o IID_IStream.

[out] ppv

Tipo: void**

Quando termina, questo metodo contiene il puntatore di interfaccia richiesto in riid. Si tratta in genere di IStorage o IStream.

Valore restituito

Tipo: HRESULT

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

Commenti

È consigliabile usare la macro IID_PPV_ARGS , definita in Objbase.h, per creare il pacchetto dei parametri riid e ppv . Questa macro fornisce l'IID corretto in base all'interfaccia a cui punta il valore in ppv, che elimina la possibilità di un errore di codifica.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlobj_core.h (includere Shlobj.h)
Libreria	Shell32.lib
DLL	Shell32.dll (versione 6.1 o successiva)

Condividi tramite