Функция StgMakeUniqueName (shlobj_core.h)

Создает уникальное имя для потока или объекта хранилища из шаблона.

Синтаксис

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

Параметры

[in] pstgParent

Тип: IStorage*

Указатель на объект IStorage .

[in] pszFileSpec

Тип: PCWSTR

Формат или шаблон для имени потока или объекта хранилища.

[in] grfMode

Тип: DWORD

Режим доступа, используемый при открытии потока или объекта хранилища. Дополнительные сведения и описания возможных значений см. в разделе Константы STGM.

[in] riid

Тип: REFIID

Ссылка на IID интерфейса, извлекаемого через ppv, обычно IID_IStorage или IID_IStream.

[out] ppv

Тип: void**

При возврате этим методом содержит указатель интерфейса, запрошенный в riid. Обычно это IStorage или IStream.

Возвращаемое значение

Тип: HRESULT

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Рекомендуется использовать макрос IID_PPV_ARGS , определенный в Objbase.h, для упаковки параметров riid и ppv . Этот макрос предоставляет правильный КОД на основе интерфейса, на который указывает значение в ppv, что исключает возможность ошибки кода.

Требования