Método IPrintCoreHelper::EnumConstrainedOptions (prcomoem.h)
O método IPrintCoreHelper::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, IPrintCoreHelper::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 ou IPrintOemUni::D evMode ou de um provedor de tíquete de impressão, 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 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 IPrintCoreHelper::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 que é apontada pelo parâmetro pConstrainedOptionList .
Retornar valor
IPrintCoreHelper::EnumConstrainedOptions deve retornar um dos valores a seguir.
| 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 explicitamente 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) |