Compartilhar via

Função SHPropStgWriteMultiple (shlobj_core.h)

  • Artigo

[Essa função está disponível por meio do Windows XP Service Pack 2 (SP2) e do Windows Server 2003. Ele pode estar alterado ou indisponível nas versões subsequentes do Windows.]

Encapsula a função IPropertyStorage::WriteMultiple para garantir que as traduções ANSI e Unicode sejam tratadas corretamente para conjuntos de propriedades preteridos.

Sintaxe

SHSTDAPI SHPropStgWriteMultiple(
  [in]                IPropertyStorage  *pps,
  [in, out, optional] UINT              *puCodePage,
                      ULONG             cpspec,
  [in]                PROPSPEC const [] rgpspec,
  [in, out]           PROPVARIANT []    rgvar,
                      PROPID            propidNameFirst
);

Parâmetros

[in] pps

Tipo: IPropertyStorage*

Um ponteiro de interface IPropertyStorage que identifica o repositório de propriedades.

[in, out, optional] puCodePage

Tipo: UINT*

Um ponteiro para o valor da página de código para propriedades de cadeia de caracteres ANSI.

cpspec

Tipo: ULONG

Uma contagem de propriedades que estão sendo definidas.

[in] rgpspec

Tipo: PROPSPEC const[]

Uma matriz de estruturas PROPSPEC que contêm as informações de propriedade a serem definidas.

[in, out] rgvar

Tipo: PROPVARIANT[]

Uma matriz de tipos PROPVARIANT para definir os valores da propriedade.

propidNameFirst

Tipo: PROPID

O valor mínimo para identificadores de propriedade quando eles devem ser alocados. O valor deve ser maior ou igual a PID_FIRST_USABLE.

Valor retornado

Tipo: HRESULT

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

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h
Biblioteca Shell32.lib
DLL Shell32.dll (versão 6.0 ou posterior)