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:

Requirements

See also

Resource Control Codes

Resource DLL Entry-Point Functions