Função StgMakeUniqueName (shlobj_core.h)

Cria um nome exclusivo para um fluxo ou objeto de armazenamento de um modelo.

Sintaxe

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

Parâmetros

[in] pstgParent

Tipo: IStorage*

Um ponteiro para um objeto IStorage .

[in] pszFileSpec

Tipo: PCWSTR

O formato ou modelo para o nome do fluxo ou objeto de armazenamento.

[in] grfMode

Tipo: DWORD

O modo de acesso a ser usado ao abrir o fluxo ou o objeto de armazenamento. Para obter mais informações e descrições dos valores possíveis, consulte Constantes STGM.

[in] riid

Tipo: REFIID

Uma referência à IID da interface a ser recuperada por meio de ppv, normalmente IID_IStorage ou IID_IStream.

[out] ppv

Tipo: void**

Quando esse método retorna, contém o ponteiro de interface solicitado em riid. Normalmente, isso é IStorage ou IStream.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

É recomendável que você use a macro IID_PPV_ARGS , definida em Objbase.h, para empacotar os parâmetros riid e ppv . Essa macro fornece o IID correto com base na interface apontada pelo valor em ppv, o que elimina a possibilidade de um erro de codificação.

Requisitos