IMAPIFolder::CopyFolder
.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 CopyFolder método Move uma subpasta. Copiar uma subpasta não com suporte em Windows Mobile powered Mensagens.
Syntax
HRESULT CopyFolder (
ULONG cbEntryID,
LPENTRYID lpEntryID,
LPCIID lpInterface,
LPVOID lpDestFolder,
LPTSTR lpszNewFolderName,
ULONG ulUIParam,
LPMAPIPROGRESS lpProgress,
ULONG ulFlags
);
Parameters
- cbEntryID
[no] Contagem de bytes no identificador de entrada apontado pelo lpEntryID.
- lpEntryID
[no] Referência a um EntryID estrutura que representa o identificador entrada da subpasta para mover; não pode ser NULL.
- lpInterface
[no] Ignorado.
- lpDestFolder
[no] Referência a aberto pasta para receber a subpasta movida.
- lpszNewFolderName
[no] Deve ser NULL.
- ulUIParam
[no] Ignorado.
- lpProgress
[no] Ignorado.
ulFlags
[no] Máscara de bits de sinalizadores que controla a operação mover. O seguinte sinalizadores podem ser definidos:FOLDER_MOVE
Este sinalizador é exigido. A subpasta será movida.
MAPI_UNICODE
O nome do pasta de destino é no formato Unicode.
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_COLLISION
O nome da pasta que está sendo movida é o mesmo de uma subpasta na pasta de destino. O provedor armazenar mensagem requer que nomes pasta seja exclusivo.
- MAPI_E_FOLDER_CYCLE
A pasta origem direta ou indiretamente contém a pasta de destino. Trabalho significativo pode foram executado antes essa condição foi descoberta, portanto, a origem e pasta de destino podem parcialmente ser modificados.
Remarks
The CopyFolder método Move uma subpasta de uma localidade para outro. A subpasta que está sendo movida é adicionada para o pasta de destino como uma subpasta. Copiar uma subpasta não com suporte em Windows Mobile powered Mensagens.
Quando CopyFolder Não consegue completo, Não presuma que nenhum trabalho foi feito. CopyFolder Podem ter sido possível mover um ou mais das mensagens e subpastas antes encontrando o erro.
Depending on o provedor armazenar mensagem, o identificador entrada do original mensagem pode ou não pode ser preservada na mensagem copiada. MAPI recomenda que os identificadores entrada ser preservadas sempre que possível, mas não é um requisito. Você pode geralmente dependem o seguinte:
- Ao mover uma pasta entre dois tipos diferentes de armazenamentos mensagem, o identificador entrada é garantida a alteração.
- Quando mover uma pasta entre dois armazenamentos mensagem do mesmo tipo, o identificador entrada quase sempre muda.
- Ao mover uma pasta para outra localidade dentro de armazenar mensagem mesmo, o identificador entrada talvez ou talvez não alteração, depending on provedor armazenar a mensagem.
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 |