IPrintCoreHelperPS::GetGlobalAttribute 方法 (prcomoem.h)
IPrintCoreHelperPS::GetGlobalAttribute 方法检索全局属性列表或特定全局属性的值。
HRESULT GetGlobalAttribute(
[in] PCSTR pszAttribute,
[out] PDWORD pdwDataType,
[out] PBYTE *ppbData,
[out] PDWORD pcbSize
);
[in] pszAttribute
指向调用方提供的缓冲区的指针,该缓冲区包含指定请求的属性的 ANSI 字符串。 如果此参数 NULL,则调用方将请求所有受支持的全局属性名称的列表,而不是指定特定的全局属性名称。
[out] pdwDataType
指向接收指定所请求属性数据类型的值的变量的指针。 此值是在 printoem.h 中定义的 EATTRIBUTE_DATATYPE 枚举类型的枚举器。
[out] ppbData
指向包含所请求数据的被调用方分配缓冲区的指针。 完成此方法后,调用方无需释放此缓冲区。
[out] pcbSize
指向变量的指针,该变量指定 pbData 参数指向的缓冲区的大小(以字节为单位)。
IPrintCoreHelperPS::GetGlobalAttribute 应返回以下值之一。
返回代码 | 描述 |
---|---|
S_OK | 方法成功。 |
E_FAIL | 方法失败。 |
E_INVALIDARG | 该方法尝试查询不存在的属性。 |
E_OUTOFMEMORY | 中的值小于要写入到 pbData指向的输出缓冲区的字节数。 |
如果调用 IPrintCoreHelperPS::GetGlobalAttribute,其 pszAttribute,pbData 参数设置为 NULL,则该方法将返回 设置为所有受支持的全局属性名称列表所需的字节数。 如果第二次调用此方法,pszAttribute 设置为 NULL,pbData 指向在上一次调用中 中指定的大小的缓冲区, 该方法返回 pdwDataType 设置为kADT_ASCII(EATTRIBUTE_DATATYPE 枚举类型的枚举器),pbData 指向所有受支持的全局支持的全局的 NULL 分隔列表属性名称。 此列表以两个 null 字符结尾。
有关 IPrintCoreHelperPS::GetGlobalAttribute的详细信息,请参阅 使用 GetGlobalAttribute。
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | prcomoem.h (include Prcomoem.h) |