Fungsi WSManPluginAuthzUserComplete (wsman.h)

Artikel
08/28/2023

Dipanggil dari titik masuk plug-in WSManPluginAuthzUser dan melaporkan otorisasi koneksi pengguna yang berhasil atau gagal.

Sintaks

DWORD WSManPluginAuthzUserComplete(
  [in]           WSMAN_SENDER_DETAILS *senderDetails,
  [in]           DWORD                flags,
  [in, optional] PVOID                userAuthorizationContext,
  [in, optional] HANDLE               impersonationToken,
  [in]           BOOL                 userIsAdministrator,
  [in]           DWORD                errorCode,
  [in, optional] PCWSTR               extendedErrorInformation
);

Parameter

[in] senderDetails

Penunjuk ke struktur WSMAN_SENDER_DETAILS yang diteruskan ke panggilan plug-in WSManPluginAuthzUser .

[in] flags

Disiapkan untuk penggunaan masa mendatang. Harus diatur ke nol.

[in, optional] userAuthorizationContext

Menentukan konteks plug-in yang ditentukan yang digunakan untuk membantu melacak informasi konteks pengguna. Konteks ini dapat dikembalikan ke beberapa panggilan, ke panggilan ini, atau ke panggilan operasi. Plug-in mengelola penghitungan referensi untuk semua panggilan. Jika waktu rekam pengguna habis atau otorisasi ulang diperlukan, infrastruktur WinRM memanggil WSManPluginAuthzReleaseContext.

[in, optional] impersonationToken

Menentukan identitas pengguna. Parameter ini adalah clientToken yang diteruskan ke senderDetails. Jika plug-in mengubah konteks pengguna, token peniruan identitas baru harus dikembalikan.

Catatan Token ini dirilis setelah operasi selesai.

[in] userIsAdministrator

Atur ke TRUE jika pengguna adalah administrator. Jika tidak, parameter ini ADALAH FALSE.

[in] errorCode

Melaporkan otorisasi yang berhasil atau gagal. Jika otorisasi berhasil, kode harus ERROR_SUCCESS. Jika pengguna tidak berwenang untuk melakukan operasi, kesalahan harus ERROR_ACCESS_DENIED. Jika kegagalan terjadi karena alasan lain, kode kesalahan yang sesuai harus digunakan. Kesalahan apa pun dari panggilan ini akan dikirim kembali sebagai paket kesalahan SOAP.

[in, optional] extendedErrorInformation

Menentukan dokumen XML yang berisi informasi kesalahan tambahan yang perlu dilaporkan ke klien. Parameter ini diabaikan jika errorCodeNO_ERROR. Bahasa antarmuka pengguna dari utas harus digunakan untuk pelokalan.

Nilai kembali

Metode mengembalikan ERROR_SUCCESS jika berhasil; jika tidak, ia mengembalikan ERROR_INVALID_PARAMETER. Jika ERROR_INVALID_PARAMETER dikembalikan, parameter senderDetails adalah NULL atau parameter bendera bukan nol.

Keterangan

Jika token peniruan yang diteruskan ke senderDetails bukan identitas yang harus dilakukan operasi, atau jika tidak ada token peniruan yang tersedia dan plug-in menentukan identitas baru untuk melakukan permintaan, plug-in harus mengembalikan peniruan baruToken yang akan digunakan infrastruktur WSMan untuk meniru klien sebelum memanggil plug-in operasi. Jika token peniruan disediakan di senderDetails dan plug-in ingin melakukan operasi di bawah identitas tersebut, plug-in harus menyalin token peniruan dari senderDetails ke dalam parameter impersonationToken . Jika plug-in ingin melakukan permintaan di bawah konteks proses host Internet Information Services (IIS), impersonationToken harus NULL. Jika impersonationTokenadalah NULL, utas akan meniru token proses sebelum memanggil ke plug-in operasi.

Jika parameter userIsAdministrator diatur ke TRUE, pengguna diizinkan untuk melihat dan menghapus shell yang dimiliki oleh pengguna yang berbeda.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7
Server minimum yang didukung	Windows Server 2008 R2
Target Platform	Windows
Header	wsman.h
Pustaka	WsmSvc.lib
DLL	WsmSvc.dll
Redistribusi	Windows Management Framework pada Windows Server 2008 dengan SP2 dan Windows Vista dengan SP2

Bagikan melalui