Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 la 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 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 significare 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 significare che il metodo è stato chiamato con pbData impostato su NULL. |
Osservazioni
Se IPrintCoreHelperPS::GetFeatureAttribute viene chiamato con i relativi pszAttribute e parametri pbData impostati su NULL, il metodo restituisce con pcbSize impostato sul numero di byte necessari per l'elenco di tutti i nomi di attributo 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 gli attributi supportati nomi per la funzionalità. Questo elenco viene terminato con due caratteri Null.
Per altre informazioni su IPrintCoreHelperPS::GetFeatureAttribute, vedere Using GetFeatureAttribute.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | prcomoem.h (include Prcomoem.h) |