IPrintCoreHelperPS::GetFeatureAttribute-Methode (prcomoem.h)

Artikel
02/29/2024

Die IPrintCoreHelperPS::GetFeatureAttribute-Methode ruft die Featureattributliste oder den Wert eines bestimmten Featureattributs ab.

Syntax

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

Parameter

[in] pszFeatureKeyword

Ein Zeiger auf einen vom Aufrufer bereitgestellten Puffer, der eine ANSI-Zeichenfolge enthält, die das Feature angibt, nach dem Schlüsselwort (keyword) abzufragen ist. Dieser Wert kann über einen vorherigen Aufruf von IPrintCoreHelperPS::EnumFeatures abgerufen werden.

[in] pszAttribute

Ein Zeiger auf einen vom Aufrufer bereitgestellten Puffer, der eine ANSI-Zeichenfolge enthält, die das angeforderte Attribut angibt. Wenn dieser Parameter NULL ist, fordert der Aufrufer eine Liste aller unterstützten Featureattributnamen an, anstatt einen bestimmten Featureattributnamen anzugeben.

[out] pdwDataType

Ein Zeiger auf eine Variable, die einen Wert empfängt, der den Datentyp des angeforderten Attributs angibt. Dieser Wert ist ein Enumerator des EATTRIBUTE_DATATYPE Enumerationstyps, der in printoem.h definiert ist.

[out] ppbData

Ein Zeiger auf einen vom Aufrufer zugeordneten Puffer, der die angeforderten Daten enthält. Nach Abschluss dieser Methode muss der Aufrufer diesen Puffer nicht freigeben.

[out] pcbSize

Ein Zeiger auf eine Variable, die die Größe des Puffers in Bytes empfängt, auf den der pbData-Parameter verweist.

Rückgabewert

IPrintCoreHelperPS::GetFeatureAttribute sollte einen der folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_FAIL	Fehler bei der Methode.
E_INVALIDARG	Die -Methode hat versucht, ein nicht vorhandenes Attribut abzufragen. Dieser Wert kann auch bedeuten, dass das Feature Schlüsselwort (keyword) nicht erkannt wurde.
E_OUTOFMEMORY	Der Wert in pcbSize war kleiner als die Anzahl der Bytes, die in den Ausgabepuffer geschrieben werden sollen, auf den pbData verweist. Dieser Wert kann auch bedeuten, dass die Methode aufgerufen wurde, wobei pbData auf NULL festgelegt ist.

Hinweise

Wenn IPrintCoreHelperPS::GetFeatureAttribute aufgerufen wird, wobei die Parameter pszAttribute und pbData auf NULL festgelegt sind, gibt die Methode zurück, wobei pcbSize auf die Anzahl der Bytes festgelegt ist, die für die Liste aller unterstützten Attributnamen für das Feature benötigt werden. Wenn diese Methode ein zweites Mal aufgerufen wird, wobei pszAttribute auf NULL festgelegt ist und pbData auf einen Puffer der Größe zeigt, die im vorherigen Aufruf in pcbSize angegeben wurde, gibt die Methode zurück, wobei pdwDataType auf kADT_ASCII (ein Enumerator des EATTRIBUTE_DATATYPE Enumerationstyps) festgelegt ist, und pbData , der auf eine durch NULL getrennte Liste aller unterstützten Attributnamen für das Feature verweist. Diese Liste wird mit zwei NULL-Zeichen beendet.