Compartilhar via

HrCreateNewWrappedObject

  • Artigo

Cria um objeto que um cliente pode acessar em um formato de caractere preferido.

Informações rápidas

Campo Valor
Exportado por:
 msmapi32.dll
Chamado por:
 Cliente
Implementado por:
 Outlook
 
HRESULT HrCreateNewWrappedObject( 
    LPVOID        pvUnwrapped, 
    ULONG         ulUnwrappedFlags, 
    ULONG         ulWrappedFlags, 
    const IID     *pIID, 
    const ULONG   *pulReserved, 
    BOOL          fCheckWrap, 
    LPVOID       *ppvWrapped 
);

Parâmetros

pvUnwrapped

[in] O objeto inicial não ajustado do Outlook. Deve implementar uma das seguintes interfaces:

ulUnwrappedFlags

[in] Sinalizadores que caracterizam o objeto inicial não ajustado. Deve ser um ou mais dos seguintes valores:

  • DDLWRAP_FLAG_ANSI — O objeto não ajustado é ANSI.

  • DDLWRAP_FLAG_UNICODE — O objeto não ajustado é UNICODE.

ulWrappedFlags

[in] Sinalizadores para o formato de caractere preferido. Deve ser um ou mais dos seguintes valores:

  • DDLWRAP_FLAG_ANSI – O objeto ajustado será exposto como ANSI.
  • DDLWRAP_FLAG_UNICODE– O objeto ajustado será exposto como UNICODE.

pIID

[in] O identificador da interface com suporte pelo objeto não ajustado; defina como NULL se for desconhecido.

pulReserved

[in] Este parâmetro não é usado. Ele deve ser NULL.

fCheckWrap

[in] Defina esse parâmetro como true se pvUnwrapped deve ser verificado em seu formato antes de encapsular; defina-o como false se o objeto deve ser encapsulado sem verificar.

ppvWrapped

[out] Um apontador para o objeto solicitado, ajustado no formato de caractere solicitado.

Valores de retorno

S_OK se a chamada for bem-sucedida; caso contrário, um código de erro.

Comentários

Passar um objeto encapsulado com fCheckWrap definido como true resultará em um objeto desembrulhado. Independentemente de o objeto estar ajustado ou não, o cliente é responsável por liberar a referência no objeto retornado.

Ao usar GetProcAddress para procurar o endereço dessa função em msmapi32.dll, especifique HrCreateNewWrappedObject@28 como o nome do procedimento.

Confira também