Partilhar via

IDiaPropertyStorage::ReadMultiple

  • Artigo

Lê as propriedades especificadas do conjunto de propriedades atual.

Sintaxe

HRESULT ReadMultiple( 
   ULONG          cpspec,
   PROPSPEC const rgpspec,
   PROPVARIANT    rgvar
);

Parâmetros

cpspec

[in] Contagem de propriedades especificadas na matriz rgpspec. Se zero, o método não retornará nenhuma propriedade, mas retornará S_OK como código de êxito.

rgpspec

[in] Uma matriz de propriedades a serem lidas. As propriedades podem ser especificadas por uma ID de propriedade ou por um nome de cadeia de caracteres opcional. Não é necessário especificar propriedades em nenhuma ordem específica na matriz. A matriz pode conter propriedades duplicadas, resultando em valores de propriedade duplicados no retorno para propriedades simples. As propriedades não simples deverão retornar acesso negado quando houver tentativa de abri-las uma segunda vez. A matriz pode conter uma combinação de IDs de propriedade e IDs de cadeia de caracteres. Essa matriz precisa ter pelo menos cpspec o número de valores de propriedade.

rgvar

[in, out] Uma matriz de estruturas PROPVARIANT (no namespace Microsoft.VisualStudio.OLE.Interop) a ser preenchida com valores para cada propriedade. A matriz precisa ter pelo menos cpspec elementos de tamanho. O chamador não precisa inicializar os valores na matriz.

Valor Retornado

Se for bem-sucedido, retornará S_OK. Retornará S_FALSE se uma ou mais propriedades não foram encontradas. Caso contrário, retornará um código de erro.

Comentários

Se uma propriedade não foi encontrada, a entrada correspondente na matriz rgvar contém um VARIANT com o tipo VT_EMPTY.

Confira também