IItem::Copy
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
9/8/2008
The Cópia método cria um copiar de um gerenciador de informações pessoais item.
Syntax
HRESULT Copy(
IItem ** ppolCopy
);
Parameters
- ppolCopy
[out] Referência ao objeto copiado IItem Gerenciador de informações pessoais.
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
The method completed successfully.
Exemplo de código
O seguinte exemplo de código demonstra como usar Cópia. O exemplo, em pItemCopy Contém um copiar do objeto IItem. Todas as propriedades é copiada, incluindo nomeado propriedades. Propriedades nomeadas criadas com o conjunto PIM_DONTREPLICATE não são copiadas embora. For more information, see GetIDsFromNames Flags.
Observação
Para tornar o exemplo de código mais fácil para ler, verificação de segurança e manipulação de erro não estão incluídos.This code example should not be used in a release configuration unless it has been modified to include them.
HRESULT CopyExample(IItem *pItem)
{
HRESULT hr = E_FAIL;
IItem *pItemCopy = NULL;
hr = pItem->Copy(&pItemCopy);
if(NULL != pItemCopy)
pItemCopy->Release();
return hr;
}
Remarks
Se você modificar BodyInk binário de um item transmitir dados (ou seja, o PIMPR_BODY_BINARY propriedade), você deve salvar o item antes de copiá-lo — caso contrário que propriedade não será copiada.
Fluxos se comportar de maneira diferente, dependendo se o item foi salvo. Você deve chamar IStream::Commit(0) (detalhes de parâmetro de zero) na transmitir antes chamado IItem::Save sobre o item. Se você não fizer isso, em seguida, o item pode ser salvo não. Isso depende se você tiver anteriormente salva o item.
Ambos PIMPR_BODY_TEXT e MapVirtualKey. PIMPR_BODY_BINARY Sempre são copiados.
Requirements
| Header | pimstore.h |
| Library | Pimstore.lib |
| Windows Mobile | Pocket PC for Windows Mobile Version 5.0 and later, Smartphone for Windows Mobile Version 5.0 and later |