Método IPrintCoreHelperPS::GetFeatureAttribute (prcomoem.h)
El método IPrintCoreHelperPS::GetFeatureAttribute recupera la lista de atributos de características o el valor de un atributo de característica específico.
Sintaxis
HRESULT GetFeatureAttribute(
[in] PCSTR pszFeatureKeyword,
[in] PCSTR pszAttribute,
[out] PDWORD pdwDataType,
[out] PBYTE *ppbData,
[out] PDWORD pcbSize
);
Parámetros
[in] pszFeatureKeyword
Puntero a un búfer proporcionado por el autor de la llamada que contiene una cadena ANSI que especifica la palabra clave de característica para la que se va a consultar. Este valor se puede obtener de una llamada anterior a IPrintCoreHelperPS::EnumFeatures.
[in] pszAttribute
Puntero a un búfer proporcionado por el autor de la llamada que contiene una cadena ANSI que especifica el atributo solicitado. Si este parámetro es NULL, el autor de la llamada solicita una lista de todos los nombres de atributo de características admitidos en lugar de especificar un nombre de atributo de característica específico.
[out] pdwDataType
Puntero a una variable que recibe un valor que especifica el tipo de datos del atributo solicitado. Este valor es un enumerador del tipo de enumeración EATTRIBUTE_DATATYPE, que se define en printoem.h.
[out] ppbData
Puntero a un búfer asignado por el destinatario que contiene los datos solicitados. Tras la finalización de este método, el autor de la llamada no necesita liberar este búfer.
[out] pcbSize
Puntero a una variable que recibe el tamaño, en bytes, del búfer al que apunta el parámetro pbData.
Valor devuelto
IPrintCoreHelperPS::GetFeatureAttribute debe devolver uno de los valores siguientes.
| Código devuelto | Descripción |
|---|---|
| S_OK | El método se realizó correctamente. |
| E_FAIL | Error en el método. |
| E_INVALIDARG | El método intentó consultar un atributo inexistente. Este valor también puede significar que no se reconoció la palabra clave feature. |
| E_OUTOFMEMORY | El valor de pcbSize era menor que el número de bytes que se van a escribir en el búfer de salida al que apunta pbData. Este valor también puede significar que se llamó al método con pbData establecido en NULL. |
Observaciones
Si se llama a IPrintCoreHelperPS::GetFeatureAttribute con sus pszAttribute y parámetros pbData establecidos en NULL, el método devuelve con pcbSize establecido en el número de bytes necesarios para la lista de todos los nombres de atributo admitidos para la característica. Si se llama a este método por segunda vez, con pszAttribute establecido en NULL y pbData apuntando a un búfer del tamaño especificado en pcbSize en la llamada anterior, el método devuelve con pdwDataType establecido en kADT_ASCII (un enumerador del tipo de enumeración EATTRIBUTE_DATATYPE) y pbData que apunta a una lista delimitada por NULL de todos los atributos admitidos. nombres de la característica. Esta lista finaliza con dos caracteres NULL.
Para obtener más información sobre IPrintCoreHelperPS::GetFeatureAttribute, vea Using GetFeatureAttribute.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | prcomoem.h (include Prcomoem.h) |