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

  • Artigo

O método IPrintCoreHelperPS::EnumConstrainedOptions fornece uma lista de todas as opções restritas em um recurso específico, com base nas configurações atuais.

Sintaxe

HRESULT EnumConstrainedOptions(
  [in, optional] IN const DEVMODE *pDevmode,
  [in]           IN DWORD         cbSize,
  [in]           IN PCSTR         pszFeatureKeyword,
  [out]          OUT PCSTR * []   pConstrainedOptionList,
  [out]          OUT DWORD        *pdwNumOptions
);

Parâmetros

[in, optional] pDevmode

Um ponteiro para uma estrutura DEVMODEW . Se esse ponteiro for fornecido, IPrintCoreHelperPS::EnumConstrainedOptions 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] pszFeatureKeyword

Uma cadeia de caracteres ANSI que contém o nome do recurso.

[out] pConstrainedOptionList

Um ponteiro para uma matriz de cadeias de caracteres ANSI. Quando IPrintCoreHelperPS::EnumConstrainedOptions retornar, essas cadeias de caracteres conterão os nomes de todas as opções restritas dentro do recurso especificado. O chamador não é responsável por liberar a matriz ou as cadeias de caracteres individuais na matriz.

[out] pdwNumOptions

Um ponteiro para uma variável que recebe o número de opções restritas na matriz apontada pelo parâmetro pConstrainedOptionList .

Retornar valor

IPrintCoreHelperPS::EnumConstrainedOptions deve retornar um dos seguintes valores.

Código de retorno Descrição
S_OK As opções restritas foram definidas para o recurso especificado.
E_FAIL O chamador forneceu informações que resultaram em uma solicitação inválida, como uma solicitação para um recurso que não existe.
E_INVALIDARG Um ou mais dos argumentos eram inválidos. Esse valor pode significar que o recurso não tem suporte.
E_OUTOFMEMORY Não havia memória suficiente para criar a matriz de opções ou o driver principal não pôde atender à solicitação devido à falta de memória.
E_UNEXPECTED ou outras falhas não listadas aqui Ocorreu uma condição inesperada. O driver principal provavelmente está em um estado inválido. O chamador deve sair com um código de falha.

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho prcomoem.h (inclua Prcomoem.h)

Confira também

IPrintCoreHelperPS

IPrintCoreHelperPS::EnumOptions