Compartilhar via


IMAPIViewContext::GetPrintSetup

Aplica-se a: Outlook 2013 | Outlook 2016

Recupera as informações de impressão atuais.

HRESULT GetPrintSetup(
ULONG ulFlags,
LPFORMPRINTSETUP FAR * lppFormPrintSetup
);

Parâmetros

ulFlags

[in] Bitmask de sinalizadores que controla o tipo das cadeias de caracteres retornadas. O seguinte sinalizador pode ser definido:

MAPI_UNICODE

As cadeias de caracteres retornadas estão no formato Unicode. Se o sinalizador MAPI_UNICODE não estiver definido, as cadeias de caracteres estarão no formato ANSI.

lppFormPrintSetup

[out] Ponteiro para um ponteiro para uma estrutura que contém as informações de impressão.

Valor de retorno

S_OK

As informações de impressão foram recuperadas com êxito.

Comentários

Objetos de formulário chamam o método IMAPIViewContext::GetPrintSetup para recuperar informações sobre a instalação da impressora antes de tentar imprimir a mensagem atual.

Observações para implementadores

Aloque os membros hDevMode e hDevName da estrutura FORMPRINTSETUP usando a função Win32 GlobalAlloc.

Notas para chamadores

Se você esperar que os membros hDevMode e hDevName da estrutura FORMPRINTSETUP apontados pelo parâmetro lppFormPrintSetup sejam cadeias de caracteres Unicode, defina ulFlags como MAPI_UNICODE. Caso contrário, GetPrintSetup retornará essas cadeias de caracteres no formato ANSI.

Libere os membros hDevMode e hDevName da estrutura FORMPRINTSETUP chamando a função Win32 GlobalFree. Libere toda a estrutura FORMPRINTSETUP chamando MAPIFreeBuffer.

Confira também

FORMPRINTSETUP

IMAPIViewContext : IUnknown