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 |
---|---|
|
The operation completed successfully. |
|
The resource ID was not found. |
|
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 |