PBEGIN_RESCALL_ROUTINE callback function (resapi.h)

Starts a call to a resource control code. The PBEGIN_RESCALL_ROUTINE type defines a pointer to this callback function.

Syntax

PBEGIN_RESCALL_ROUTINE PbeginRescallRoutine;

DWORD PbeginRescallRoutine(
  [in]  RESID Resource,
  [in]  DWORD ControlCode,
  [in]  PVOID InBuffer,
  [in]  DWORD InBufferSize,
  [out] PVOID OutBuffer,
  [in]  DWORD OutBufferSize,
  [out] LPDWORD BytesReturned,
  [in]  PRES_CTL_CTX context,
  [out] PBOOL ReturnedAsynchronously
)
{...}

Parameters

[in] Resource

The resource ID for the resource.

[in] ControlCode

The control code to call.

[in] InBuffer

A pointer to the buffer that contains the input data for the call to the control code.

[in] InBufferSize

The size of the buffer specified by InBuffer, in bytes.

[out] OutBuffer

A pointer to the buffer that contains the output data for the call to the control code.

[in] OutBufferSize

The size of the buffer specified by OutBuffer, in bytes.

[out] BytesReturned

The size of the data returned by OutBuffer, in bytes.

[in] context

The context to the resource control code that was called.

Windows Server 2012 R2:  This parameter was added in Windows Server 2016.

[out] ReturnedAsynchronously

TRUE if the operation returns asynchronously; otherwise, FALSE.

Windows Server 2012 R2:  This parameter was added in Windows Server 2016.

Return value

The function returns one of the following values, or a system error code:

Return code	Description
ERROR_SUCCESS	The operation completed successfully.
ERROR_RESOURCE_NOT_FOUND	The resource ID was not found.
ERROR_INVALID_FUNCTION	The requested control code is not supported.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows Server 2012 R2
Target Platform	Windows
Header	resapi.h

See also

Resource Control Codes

Resource DLL Entry-Point Functions