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

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