WSManSendShellInput-Funktion (wsman.h)

Leitet den Eingabedatenstrom an einen ausgeführten Befehl oder an die Shell weiter.

Syntax

void WSManSendShellInput(
  [in]           WSMAN_SHELL_HANDLE     shell,
  [in, optional] WSMAN_COMMAND_HANDLE   command,
                 DWORD                  flags,
  [in]           PCWSTR                 streamId,
  [in]           WSMAN_DATA             *streamData,
                 BOOL                   endOfStream,
  [in]           WSMAN_SHELL_ASYNC      *async,
  [out]          WSMAN_OPERATION_HANDLE *sendOperation
);

Parameter

[in] shell

Gibt das Shellhandle an, das von einem WSManCreateShell-Aufruf zurückgegeben wird. Dieser Parameter darf nicht NULL sein.

[in, optional] command

Gibt das Befehlshandle an, das von einem WSManRunShellCommand-Aufruf zurückgegeben wird. Dieses Handle sollte durch Aufrufen der WSManCloseCommand-Methode geschlossen werden.

flags

Für die zukünftige Verwendung reserviert. Muss auf 0 festgelegt werden.

[in] streamId

Gibt die Eingabestream-ID an. Dieser Parameter darf nicht NULL sein.

[in] streamData

Verwendet die WSMAN_DATA-Struktur , um die Datenstromdaten anzugeben, die an den Befehl oder die Shell gesendet werden sollen. Diese Struktur sollte vom aufrufenden Client zugewiesen werden und muss bis zum Abschluss von WSManSendShellInput zugeordnet bleiben. Wenn das Ende des Datenstroms erreicht wurde, sollte der endOfStream-Parameter auf TRUE festgelegt werden.

endOfStream

Legen Sie auf TRUE fest, wenn das Ende des Datenstroms erreicht wurde. Andernfalls wird dieser Parameter auf FALSE festgelegt.

[in] async

Definiert eine asynchrone Struktur. Die asynchrone Struktur enthält einen optionalen Benutzerkontext und eine obligatorische Rückruffunktion. Weitere Informationen finden Sie in der WSMAN_SHELL_ASYNC-Struktur . Dieser Parameter darf NICHT NULL sein und sollte durch Aufrufen der WSManCloseCommand-Methode geschlossen werden.

[out] sendOperation

Definiert das Vorgangshandle für den Sendevorgang. Dieses Handle wird von einem erfolgreichen Aufruf der Funktion zurückgegeben und kann verwendet werden, um den Sendevorgang asynchron abzubrechen. Dieses Handle sollte durch Aufrufen der WSManCloseOperation-Methode geschlossen werden. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Keine

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7
Unterstützte Mindestversion (Server)	Windows Server 2008 R2
Zielplattform	Windows
Kopfzeile	wsman.h
Bibliothek	WsmSvc.lib
DLL	WsmSvc.dll
Verteilbare Komponente	Windows Management Framework unter Windows Server 2008 mit SP2, Windows Vista mit SP1 und Windows Vista mit SP2