Freigeben über

WSManConnectShellCommand-Funktion (wsman.h)

  • Artikel

Stellt eine Verbindung mit einem vorhandenen Befehl her, der in einer Shell ausgeführt wird.

Syntax

void WSManConnectShellCommand(
  [in, out]      WSMAN_SHELL_HANDLE   shell,
                 DWORD                flags,
  [in]           PCWSTR               commandID,
  [in, optional] WSMAN_OPTION_SET     *options,
  [in, optional] WSMAN_DATA           *connectXml,
  [in]           WSMAN_SHELL_ASYNC    *async,
  [out]          WSMAN_COMMAND_HANDLE *command
);

Parameter

[in, out] shell

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

flags

Für die zukünftige Verwendung reserviert. Muss Null sein.

[in] commandID

Eine NULL-Zeichenfolge, die einen bestimmten Befehl identifiziert, der derzeit in der Serversitzung ausgeführt wird und mit dem der Client eine Verbindung herstellen möchte.

[in, optional] options

Definiert eine Reihe von Optionen für den Befehl. Diese Optionen werden an den Dienst übergeben, um die Befehlsausführung zu ändern oder zu verfeinern. Dieser Parameter kann NULL sein. Weitere Informationen zu den Optionen finden Sie unter WSMAN_OPTION_SET.

[in, optional] connectXml

Ein Zeiger auf eine WSMAN_DATA-Struktur , die einen offenen Kontext für den Verbindungsshellvorgang definiert. Der Inhalt muss eine gültige XML-Zeichenfolge sein. Dieser Parameter kann NULL sein.

[in] async

Definiert eine asynchrone Struktur, die einen optionalen Benutzerkontext und eine obligatorische Rückruffunktion enthält. Weitere Informationen finden Sie unter WSMAN_SHELL_ASYNC. Dieser Parameter darf nicht NULL sein.

[out] command

Dieses Handle wird bei einem erfolgreichen Aufruf zurückgegeben und zum Senden und Empfangen von Daten und zum Signalisieren des Befehls verwendet. Wenn Sie dieses Handle verwendet haben, schließen Sie es, indem Sie die WSManCloseCommand-Methode aufrufen. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Keine

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 8
Unterstützte Mindestversion (Server) Windows Server 2012
Zielplattform Windows
Kopfzeile wsman.h
Bibliothek WsmSvc.lib
DLL WsmSvc.dll