WSManPluginReportContext function (wsman.h)

Reports shell and command context back to the Windows Remote Management (WinRM) infrastructure so that further operations can be performed against the shell and/or command. This method is called only for WSManPluginShell and WSManPluginCommand plug-in entry points.

Syntax

DWORD WSManPluginReportContext(
  [in] WSMAN_PLUGIN_REQUEST *requestDetails,
  [in] DWORD                flags,
  [in] PVOID                context
);

Parameters

[in] requestDetails

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

[in] flags

Reserved for future use. Must be set to zero.

[in] context

Defines the value to pass into all future shell and command operations. Represents either the shell or the command. This value should be unique for all shells, and it should also be unique for all commands associated with a shell.

Return value

The method returns NO_ERROR if it succeeded; otherwise, it returns an error code. If this method returns an error, the plug-in should shut down the current operation and call the WSManPluginOperationComplete method.

Requirements