Metodo IPrintCoreHelperPS::GetFeatureAttribute (prcomoem.h)

  • Articolo

Il metodo IPrintCoreHelperPS::GetFeatureAttribute recupera l'elenco di attributi delle funzionalità o il valore di un attributo di funzionalità specifico.

Sintassi

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

Parametri

[in] pszFeatureKeyword

Puntatore a un buffer fornito dal chiamante che contiene una stringa ANSI che specifica la parola chiave della funzionalità per cui eseguire una query. Questo valore può essere ottenuto da una chiamata precedente a IPrintCoreHelperPS::EnumFeatures.

[in] pszAttribute

Puntatore a un buffer fornito dal chiamante che contiene una stringa ANSI che specifica l'attributo richiesto. Se questo parametro è NULL, il chiamante richiede un elenco di tutti i nomi degli attributi di funzionalità supportati anziché specificare un nome di attributo di funzionalità specifico.

[out] pdwDataType

Puntatore a una variabile che riceve un valore che specifica il tipo di dati dell'attributo richiesto. Questo valore è un enumeratore del tipo di enumerazione EATTRIBUTE_DATATYPE, definito in printoem.h.

[out] ppbData

Puntatore a un buffer allocato dal chiamato contenente i dati richiesti. Al termine di questo metodo, il chiamante non deve rilasciare questo buffer.

[out] pcbSize

Puntatore a una variabile che riceve le dimensioni, in byte, del buffer a cui punta il parametro pbData .

Valore restituito

IPrintCoreHelperPS::GetFeatureAttribute deve restituire uno dei valori seguenti.

Codice restituito Descrizione
S_OK Il metodo è riuscito.
E_FAIL Il metodo non è riuscito.
E_INVALIDARG Il metodo ha tentato di eseguire una query per un attributo inesistente. Questo valore potrebbe anche indicare che la parola chiave feature non è stata riconosciuta.
E_OUTOFMEMORY Il valore in pcbSize è minore del numero di byte da scrivere nel buffer di output a cui punta pbData. Questo valore potrebbe anche indicare che il metodo è stato chiamato con pbData impostato su NULL.

Commenti

Se IPrintCoreHelperPS::GetFeatureAttribute viene chiamato con i parametri pszAttribute e pbData impostati su NULL, il metodo restituisce con pcbSize impostato sul numero di byte necessari per l'elenco di tutti i nomi di attributi supportati per la funzionalità. Se questo metodo viene chiamato una seconda volta, con pszAttribute impostato su NULL e pbData che punta a un buffer delle dimensioni specificate in pcbSize nella chiamata precedente, il metodo restituisce con pdwDataType impostato su kADT_ASCII (enumeratore del tipo di enumerazione EATTRIBUTE_DATATYPE ) e pbData che punta a un elenco delimitato da NULL di tutti i nomi di attributi supportati per la funzionalità. Questo elenco viene terminato con due caratteri Null.

Per altre informazioni su IPrintCoreHelperPS::GetFeatureAttribute, vedere Using GetFeatureAttribute.For more information about IPrintCoreHelperPS::GetFeatureAttribute, see Using GetFeatureAttribute.

Requisiti

Requisito Valore
Piattaforma di destinazione Desktop
Intestazione prcomoem.h (include Prcomoem.h)

Vedi anche

IPrintCoreHelperPS

IPrintCoreHelperPS::GetGlobalAttribute

IPrintCoreHelperPS::GetOptionAttribute