Compartilhar via

Função SHPropStgReadMultiple (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::ReadMultiple para garantir que as traduções ANSI e Unicode sejam tratadas corretamente para conjuntos de propriedades preteridos.

Sintaxe

SHSTDAPI SHPropStgReadMultiple(
  [in]  IPropertyStorage  *pps,
        UINT              uCodePage,
        ULONG             cpspec,
  [in]  PROPSPEC const [] rgpspec,
  [out] PROPVARIANT []    rgvar
);

Parâmetros

[in] pps

Tipo: IPropertyStorage*

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

uCodePage

Tipo: UINT

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

cpspec

Tipo: ULONG

Uma contagem de propriedades que estão sendo lidas.

[in] rgpspec

Tipo: PROPSPEC const[]

Uma matriz de propriedades a serem lidas.

[out] rgvar

Tipo: PROPVARIANT[]

Uma matriz de tipos PROPVARIANT que, quando essa função retorna com êxito, recebe os valores da propriedade.

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.

Requisitos

Requisito Valor
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)