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

Artigo
02/26/2024

O método IPrintCoreHelperPS::GetOptionAttribute recupera a lista de atributos de opção ou o valor de um atributo de opção específico.

Sintaxe

HRESULT GetOptionAttribute(
  [in]  PCSTR  pszFeatureKeyword,
  [in]  PCSTR  pszOptionKeyword,
  [in]  PCSTR  pszAttribute,
  [out] PDWORD pdwDataType,
  [out] PBYTE  *ppbData,
  [out] PDWORD pcbSize
);

Parâmetros

[in] pszFeatureKeyword

Um ponteiro para um buffer fornecido pelo chamador que contém uma cadeia de caracteres ANSI que especifica o recurso que palavra-chave consultar.

[in] pszOptionKeyword

Um ponteiro para um buffer fornecido pelo chamador que contém uma cadeia de caracteres ANSI que especifica a opção palavra-chave a ser consultada. Esse valor pode ser obtido de uma chamada anterior para IPrintCoreHelperPS::EnumOptions.

[in] pszAttribute

Um ponteiro para um buffer fornecido pelo chamador que contém uma cadeia de caracteres ANSI que especifica o atributo solicitado. Se esse parâmetro for NULL, o chamador solicitará uma lista de todos os nomes de atributo com suporte para a opção em vez de especificar um nome de atributo específico para a opção.

[out] pdwDataType

Um ponteiro para uma variável que recebe um valor que especifica o tipo de dados do atributo solicitado. Esse valor é um enumerador do tipo de enumeração EATTRIBUTE_DATATYPE, que é definido em printoem.h.

[out] ppbData

Um ponteiro para um buffer alocado pelo receptor que contém os dados solicitados. Após a conclusão desse método, o chamador não precisa liberar esse buffer.

[out] pcbSize

Um ponteiro para uma variável que recebe o tamanho, em bytes, do buffer apontado pelo parâmetro pbData .

Retornar valor

IPrintCoreHelperPS::GetOptionAttribute deve retornar um dos valores a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_FAIL	O método falhou.
E_INVALIDARG	O método tentou consultar um atributo inexistente. Esse valor também pode significar que o nome ou a opção do recurso palavra-chave nome ou opção palavra-chave nome não foram reconhecidos.
E_OUTOFMEMORY	O valor em pcbSize era menor que o número de bytes a serem gravados no buffer de saída apontado por pbData.

Comentários

Se IPrintCoreHelperPS::GetOptionAttributefor chamado com seus parâmetros pszAttribute e pbData definidos como NULL, o método retornará com pcbSize definido como o número de bytes necessários para a lista de todos os nomes de atributo com suporte para a opção. Se esse método for chamado uma segunda vez, com pszAttribute definido como NULL e pbData apontando para um buffer do tamanho especificado em pcbSize na chamada anterior, o método retorna com pdwDataType definido como kADT_ASCII (um enumerador do tipo de enumeração EATTRIBUTE_DATATYPE ) e pbData apontando para uma lista delimitada por NULL de todos os nomes de atributo com suporte para a opção. Essa lista é encerrada com dois caracteres nulos.