Compartilhar via


IMAPISupport::NewUID

Aplica-se a: Outlook 2013 | Outlook 2016

Cria uma nova estrutura MAPIUID a ser usada como um identificador exclusivo.

HRESULT NewUID(
LPMAPIUID lpMuid
);

Parâmetros

lpMuid

Um ponteiro para a nova estrutura MAPIUID .

Valor de retorno

S_OK

A nova estrutura MAPIUID foi criada.

Comentários

O método IMAPISupport::NewUID é implementado para todos os objetos de suporte. Provedores de serviços e serviços de mensagem chamam NewUID sempre que precisam gerar um identificador exclusivo de longo prazo. Um provedor de armazenamento de mensagens, por exemplo, pode chamar NewUID para obter um MAPIUID para colocar na propriedade PR_SEARCH_KEY (PidTagSearchKey) de uma mensagem recém-criada.

Notas para chamadores

Não confunda a estrutura MAPIUID que você registra em tempo de logon com as estruturas MAPIUID que o método NewUID cria. A estrutura MAPIUID que você registra quando chama o método IMAPISupport::SetProviderUID representa seu catálogo de endereços ou provedor de armazenamento de mensagens para MAPI e é usada para distinguir identificadores de entrada que diferentes provedores criam. Essa estrutura MAPIUID deve ser codificada e não obtida por meio de uma chamada para NewUID.

Confira também

MAPIUID

IMAPISupport: IUnknown