PTReleaseMemory function (prntvpt.h)

Article
10/13/2021

Releases buffers associated with print tickets and print capabilities.

Syntax

HRESULT PTReleaseMemory(
  [in] PVOID pBuffer
);

Parameters

[in] pBuffer

A pointer to a buffer allocated during a call to a print ticket API.

Return value

If the operation succeeds, the return value is S_OK, otherwise the HRESULT contains an error code.

For more information about COM error codes, see Error Handling.

Remarks

Note This is a blocking or synchronous function and might not return immediately. How quickly this function returns depends on run-time factors such as network status, print server configuration, and printer driver implementation—factors that are difficult to predict when writing an application. Calling this function from a thread that manages interaction with the user interface could make the application appear to be unresponsive.

Use this function to release the DEVMODE buffer returned by PTConvertPrintTicketToDevMode.

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	prntvpt.h
Library	Prntvpt.lib
DLL	Prntvpt.dll