Función StgMakeUniqueName (shlobj_core.h)

Crea un nombre único para una secuencia o un objeto de almacenamiento a partir de una plantilla.

Sintaxis

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

Parámetros

[in] pstgParent

Tipo: IStorage*

Puntero a un objeto IStorage .

[in] pszFileSpec

Tipo: PCWSTR

Formato o plantilla para el nombre de la secuencia o del objeto de almacenamiento.

[in] grfMode

Tipo: DWORD

Modo de acceso que se va a usar al abrir la secuencia o el objeto de almacenamiento. Para obtener más información y descripciones de los valores posibles, vea StGM Constants.

[in] riid

Tipo: REFIID

Referencia al IID de la interfaz que se va a recuperar a través de ppv, normalmente IID_IStorage o IID_IStream.

[out] ppv

Tipo: void**

Cuando este método vuelve, contiene el puntero de interfaz solicitado en riid. Esto suele ser IStorage o IStream.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Se recomienda usar la macro IID_PPV_ARGS , definida en Objbase.h, para empaquetar los parámetros riid y ppv . Esta macro proporciona el IID correcto basado en la interfaz a la que apunta el valor de ppv, lo que elimina la posibilidad de un error de codificación.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlobj_core.h (incluya Shlobj.h)
Library	Shell32.lib
Archivo DLL	Shell32.dll (versión 6.1 o posterior)