Fungsi WSManCreateShellEx (wsman.h)

Membuat objek shell dengan menggunakan fungsionalitas yang sama dengan fungsi WSManCreateShell , dengan penambahan ID shell yang ditentukan klien. Handel shell yang dikembalikan mengidentifikasi objek yang menentukan konteks di mana perintah dapat dijalankan. Konteks didefinisikan oleh variabel lingkungan, aliran input dan output, dan direktori kerja. Konteks dapat secara langsung memengaruhi perilaku perintah. Konteks shell dibuat pada komputer jarak jauh yang ditentukan oleh parameter koneksi dan diautentikasi dengan menggunakan parameter kredensial.

Sintaks

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

Menentukan handel sesi yang dikembalikan oleh panggilan WSManCreateSession . Parameter ini tidak boleh NULL.

flags

Disiapkan untuk penggunaan masa mendatang. Harus 0.

[in] resourceUri

Menentukan jenis shell yang akan dibuat. Jenis shell didefinisikan oleh URI unik. Objek shell aktual yang dikembalikan oleh panggilan tergantung pada URI yang ditentukan. Parameter ini tidak boleh NULL. Untuk membuat shell cmd.exe Windows, gunakan URI sumber daya WSMAN_CMDSHELL_URI .

[in] shellId

Klien menentukan shellID.

[in, optional] startupInfo

Penunjuk ke struktur WSMAN_SHELL_STARTUP_INFO yang menentukan aliran input dan output, direktori kerja, batas waktu diam, dan opsi untuk shell. Jika parameter ini NULL, nilai default akan digunakan.

[in, optional] options

Penunjuk ke struktur WSMAN_OPTION_SET yang menentukan sekumpulan opsi untuk shell.

[in, optional] createXml

Penunjuk ke struktur WSMAN_DATA yang menentukan konteks terbuka untuk shell. Konten harus berupa string XML yang valid. Parameter ini bisa NULL.

[in] async

Mendefinisikan struktur asinkron. Struktur asinkron berisi konteks pengguna opsional dan fungsi panggilan balik wajib. Lihat struktur WSMAN_SHELL_ASYNC untuk informasi selengkapnya. Parameter ini tidak boleh NULL dan harus ditutup dengan memanggil metode WSManCloseShell .

[out] shell

Menentukan handel shell yang secara unik mengidentifikasi objek shell. Handel sumber daya digunakan untuk melacak titik akhir klien untuk shell dan digunakan oleh metode WinRM lainnya untuk berinteraksi dengan objek shell. Objek shell harus dihapus dengan memanggil metode WSManCloseShell . Parameter ini tidak boleh NULL.

Nilai kembali

Tidak ada

Persyaratan