Método IPrintCoreHelperPS::GetOption (prcomoem.h)

Artigo
02/26/2024

O método IPrintCoreHelperPS::GetOption obtém uma opção especificada para um determinado recurso.

Sintaxe

HRESULT GetOption(
  [in, optional] const DEVMODE *pDevmode,
  [in]           DWORD         cbSize,
  [in]           PCSTR         pszFeatureRequested,
  [out]          PCSTR         *ppszOption
);

Parâmetros

[in, optional] pDevmode

Um ponteiro para uma estrutura DEVMODEW. Se esse ponteiro for fornecido, IPrintCoreHelperPS::GetOption deverá usar a estrutura DEVMODEW apontada por pDevmode em vez da estrutura DEVMODEW padrão ou atual. Se esse método for chamado do provedor de plug-in ou de IPrintOemPS::D evMode, esse parâmetro será necessário. Na maioria das outras situações, o parâmetro deve ser NULL. Quando o driver principal define pDevmode como NULL, ele modifica seu estado interno em vez do da estrutura DEVMODEW passada. Isso é necessário durante operações como a substituição completa da interface do usuário, em que a estrutura DEVMODEW retornada por uma DDI, como DrvDocumentPropertySheets, está sendo atendida pelo módulo de interface do usuário do driver principal.

[in] cbSize

O tamanho, em bytes, da estrutura DEVMODEW apontada pelo parâmetro pDevmode .

[in] pszFeatureRequested

Um ponteiro para a cadeia de caracteres ANSI que contém o nome do recurso como ele aparece no arquivo PPD.

[out] ppszOption

Um ponteiro para uma variável que contém o endereço de uma cadeia de caracteres ANSI. Quando IPrintCoreHelperPS::GetOption retorna, a cadeia de caracteres deve conter o palavra-chave para a opção selecionada no momento, como aparece no arquivo de configuração. O chamador não deve modificar essa cadeia de caracteres e não deve liberar a memória associada a essa cadeia de caracteres.

Retornar valor

IPrintCoreHelperPS::GetOption deve retornar um dos seguintes valores.

Código de retorno	Descrição
S_OK	O método lê a opção para o recurso especificado.
E_FAIL	O chamador forneceu informações que resultaram em uma solicitação inválida. Por exemplo, o recurso que foi solicitado não existe.
E_INVALIDARG	Os argumentos eram inválidos. Esse valor pode significar que o recurso não tem suporte ou que muitas opções foram solicitadas para o recurso.
E_OUTOFMEMORY	O driver principal não pôde atender à solicitação porque não havia memória suficiente.
E_UNEXPECTED ou outros códigos de retorno não listados aqui	O driver principal parece estar em um estado inválido. O chamador deve retornar um código de falha.

Comentários

IPrintCoreHelperPS::GetOption não pode ser usado para recursos que permitem que várias opções sejam definidas simultaneamente.

As palavras-chave do recurso são definidas no arquivo PPD. Além disso, o driver Pscript5 dá suporte a várias palavras-chave reservadas para opções armazenadas em sua estrutura DEVMODEWprivada. Para obter a lista de recursos Pscript5, consulte Mapeamento de palavras-chave.

O chamador não deve liberar a cadeia de caracteres apontada por ppszOption e não deve modificar a cadeia de caracteres de forma alguma.