WSManCreateShellEx-Funktion (wsman.h)

Erstellt ein Shellobjekt mithilfe der gleichen Funktionalität wie die WSManCreateShell-Funktion , wobei eine vom Client angegebene Shell-ID hinzugefügt wird. Das zurückgegebene Shellhandle identifiziert ein Objekt, das den Kontext definiert, in dem Befehle ausgeführt werden können. Der Kontext wird durch die Umgebungsvariablen, die Eingabe- und Ausgabestreams und das Arbeitsverzeichnis definiert. Der Kontext kann sich direkt auf das Verhalten eines Befehls auswirken. Auf dem Remotecomputer, der durch den Verbindungsparameter angegeben wird, wird ein Shellkontext erstellt und mit dem Parameter credentials authentifiziert.

Syntax

void WSManCreateShellEx(
  [in, out]      WSMAN_SESSION_HANDLE     session,
                 DWORD                    flags,
  [in]           PCWSTR                   resourceUri,
  [in]           PCWSTR                   shellId,
  [in, optional] WSMAN_SHELL_STARTUP_INFO *startupInfo,
  [in, optional] WSMAN_OPTION_SET         *options,
  [in, optional] WSMAN_DATA               *createXml,
  [in]           WSMAN_SHELL_ASYNC        *async,
  [out]          WSMAN_SHELL_HANDLE       *shell
);

Parameter

[in, out] session

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

flags

Für die zukünftige Verwendung reserviert. Muss den Wert 0 (null) haben.

[in] resourceUri

Definiert den zu erstellenden Shelltyp. Der Shelltyp wird durch einen eindeutigen URI definiert. Das tatsächliche Shellobjekt, das vom Aufruf zurückgegeben wird, ist vom angegebenen URI abhängig. Dieser Parameter darf nicht NULL sein. Verwenden Sie zum Erstellen einer Windows cmd.exe-Shell den ressourcen-URI WSMAN_CMDSHELL_URI .

[in] shellId

Die vom Client angegebene shellID.

[in, optional] startupInfo

Ein Zeiger auf eine WSMAN_SHELL_STARTUP_INFO-Struktur , die die Eingabe- und Ausgabestreams, das Arbeitsverzeichnis, das Leerlauftimeout und die Optionen für die Shell angibt. Wenn dieser Parameter NULL ist, werden die Standardwerte verwendet.

[in, optional] options

Ein Zeiger auf eine WSMAN_OPTION_SET-Struktur , die eine Reihe von Optionen für die Shell angibt.

[in, optional] createXml

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

[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 WSManCloseShell-Methode geschlossen werden.

[out] shell

Definiert ein Shellhandle, das das Shellobjekt eindeutig identifiziert. Das Ressourcenhandle dient zum Nachverfolgen des Clientendpunkts für die Shell und wird von anderen WinRM-Methoden für die Interaktion mit dem Shellobjekt verwendet. Das Shellobjekt sollte durch Aufrufen der WSManCloseShell-Methode gelöscht werden. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Keine

Anforderungen

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