Edit

Share via

WSMAN_PLUGIN_SEND callback function (wsman.h)

  • Article

Defines the send callback for a plug-in. This function is called for each object that is received from a client. Each object received causes the callback to be called once. After the data is processed, the Windows Remote Management (WinRM) plug-in calls WSManPluginOperationComplete to acknowledge receipt and to allow the next object to be delivered.

The DLL entry point name must be WSManPluginSend.

Syntax

WSMAN_PLUGIN_SEND WsmanPluginSend;

void WsmanPluginSend(
  WSMAN_PLUGIN_REQUEST *requestDetails,
  DWORD flags,
  PVOID shellContext,
  PVOID commandContext,
  PCWSTR stream,
  WSMAN_DATA *inboundData
)
{...}

Parameters

requestDetails

A pointer to a WSMAN_PLUGIN_REQUEST structure that specifies the resource URI, options, locale, shutdown flag, and handle for the request.

flags

If this is the last object for the stream, this parameter is set to WSMAN_FLAG_NO_MORE_DATA. Otherwise, it is set to zero.

shellContext

Specifies the context that was received when the shell was created.

commandContext

If this request is aimed at a command and not a shell, this is the context returned from the winrm create operation; otherwise, this parameter is NULL.

stream

Specifies the stream that is associated with the inbound object.

inboundData

A pointer to a WSMAN_DATA structure that contains data being sent to the specified stream. It is in the form of binary data.

Return value

None

Requirements

Requirement Value
Minimum supported client Windows 7
Minimum supported server Windows Server 2008 R2
Target Platform Windows
Header wsman.h
Redistributable Windows Management Framework on Windows Server 2008 with SP2, Windows Vista with SP1, and Windows Vista with SP2