IMAPIProp::SetProps

9/8/2008

The SetProps método atualiza um ou mais propriedades.

Syntax

HRESULT SetProps (
  ULONG cValues,
  LPSPropValue lpPropArray,
  LPSPropProblemArray FAR * lppProblems
);

Parameters

• cValues
  [no] Contagem de valores propriedade apontado pelo lpPropArray; pode ser zero.

• lpPropArray
  [no] Referência a uma matriz de SPropValue Estruturas mantendo valores propriedade a ser atualizada; não pode ser NULL.

• lppProblems
  [no] Ignorado.

Return Value

This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED GPSGetPosition, e E_FAIL, as well as o seguinte.

• S_OK
  Indica sucesso.

• MAPI_E_COMPUTED
  A propriedade não pode ser atualizada porque ele é somente leitura, computada pelo provedor de serviço responsável o objeto.

• MAPI_E_INVALID_TYPE
  Tipo de propriedade é inválido.

• MAPI_E_NO_ACCESS
  Houve uma tentativa para modificar um objeto READ-ONLY ou para acessar um objeto para que o usuário possui permissões insuficientes.

• MAPI_E_NOT_ENOUGH_MEMORY
  A propriedade não pode ser atualizada porque ele é maior do que o tamanho do buffer RPC.

• MAPI_E_UNEXPECTED_TYPE
  Tipo de propriedade não é o tipo esperado pela implementação chamado.

Remarks

Se você incluir uma marca propriedade para uma propriedade que é sem suporte o objeto e a implementação de SetProps Permite a criação de novas propriedades, a propriedade é adicionada ao objeto. Qualquer valor anterior armazenado com o identificador propriedade usada para a nova propriedade será descartado.

The S_OK valor de retorno não garante que todas as propriedades foram atualizadas com êxito. Alguns provedores armazenar em cache SetProps Chamadas até que eles recebem um chamar que requer intervenção do provedor, such as IMAPIProp::GetProps. Portanto, é possível receber valores de erro relacionadas ao SetProps chamar com as chamadas posteriores.

Ao atualizar propriedades grandes, SetProps pode falhar e retornar MAPI_E_NOT_ENOUGH_MEMORY. Não há tamanho máximo de propriedades, e objetos diferentes podem ter limites diferentes. Se você lidar com propriedades potencialmente grandes, chamar OpenProperty em vez de SetProps Quando SetProps Retorna este valor de erro.

Requirements

Header	mapidefs.h
Library	cemapi.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2002 and later, Smartphone 2002 and later

See Also

Reference

IMAPIProp
IMAPIProp::GetProps
MAPIFreeBuffer
SPropProblemArray
SPropValue

Other Resources

Messaging