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

Artigo
03/05/2024

O IPrintCoreUI2::EnumConstrainedOptions método determina quais opções de um recurso são restritas.

Sintaxe

HRESULT EnumConstrainedOptions(
  [in]  POEMUIOBJ poemuiobj,
  [in]  DWORD     dwFlags,
  [in]  PCSTR     pszFeatureKeyword,
  [out] PZZSTR    pmszConstrainedOptionList,
  [in]  DWORD     cbSize,
  [out] PDWORD    pcbNeeded
);

Parâmetros

[in] poemuiobj

Ponteiro para o contexto atual, uma estrutura OEMUIOBJ .

[in] dwFlags

É reservado e deve ser definido como zero.

[in] pszFeatureKeyword

Ponteiro para um buffer fornecido pelo chamador que contém o único recurso palavra-chave de interesse para o chamador.

[out] pmszConstrainedOptionList

Ponteiro para um buffer fornecido pelo chamador que recebe a lista de palavras-chave de opção, no formato MULTI_SZ, para esse recurso. Cada palavra-chave representa uma opção restrita na configuração atual.

Defina esse parâmetro como NULL para simplesmente consultar o tamanho (*pcbNeeded) da lista de opções restritas sem ter a lista preenchida.

[in] cbSize

Especifica o tamanho, em bytes, do buffer apontado por pmszConstrainedOptionList.

[out] pcbNeeded

Ponteiro para um local de memória que recebe o tamanho real, em bytes, da lista de opções restritas.

Retornar valor

Esse método deve retornar um dos valores a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido. O método também deverá retornar esse valor se nenhuma das opções do recurso for restrita. Nesse caso, o método deve colocar um caractere nulo no buffer apontado por pmszConstrainedOptionList e deve definir *pcbNeeded como 1.
E_OUTOFMEMORY	O valor em cbSize era menor que o número de bytes a serem gravados no buffer de saída (o buffer apontado por pmszConstrainedOptionList). O método foi chamado com pmszConstrainedOptionList definido como NULL.
E_INVALIDARG	A cadeia de caracteres apontada por pszFeatureKeyword não era um recurso reconhecido. O parâmetro poemuiobj apontou para um objeto de contexto inválido. A adesão do recurso não correspondeu à do objeto de contexto apontado por peomuiobj. (Consulte Substituindo Driver-Supplied páginas de folha de propriedades.)
E_FAIL	O método falhou.
E_NOTIMPL	O método não tem suporte.

Comentários

Esse método tem suporte apenas para plug-ins de interface do usuário do Windows XP Pscript5 que substituem totalmente as páginas de interface do usuário padrão do driver principal e só tem suporte durante as funções IPrintOemUI::D ocumentPropertySheets e IPrintOemUI::D evicePropertySheets e suas rotinas de retorno de chamada da folha de propriedades. Consulte Substituindo Driver-Supplied páginas de folha de propriedades para obter mais informações.

Para reduzir a necessidade de fazer duas chamadas por acesso a dados, passe ao método um buffer de saída de um tamanho fixo (1 KB, por exemplo) e, em seguida, marcar o valor retornado da função. Se o método retornar S_OK, o buffer já conterá os dados de interesse. Se o método retornar E_OUTOFMEMORY, o valor em *pcbNeeded será o tamanho do buffer necessário para manter os dados de interesse. Em seguida, o chamador deve alocar um buffer desse tamanho maior e prosseguir com uma segunda chamada para o método .