Fungsi WsMatchPolicyAlternative (webservices.h)

Artikel
08/27/2023

Memverifikasi bahwa Alternatif Kebijakan kompatibel dengan Batasan Kebijakan yang ditentukan. Jika alternatif kompatibel, struktur batasan diisi dengan informasi Kebijakan.

Catatan Lihat Keterangan di halaman ini untuk informasi tentang struktur batasan.

Sintaks

HRESULT WsMatchPolicyAlternative(
  [in]           WS_POLICY             *policy,
  [in]           ULONG                 alternativeIndex,
  [in]           WS_POLICY_CONSTRAINTS *policyConstraints,
  [in]           BOOL                  matchRequired,
  [in]           WS_HEAP               *heap,
  [in, optional] WS_ERROR              *error
);

Parameter

[in] policy

Penunjuk ke objek WS_POLICY yang berisi alternatif.

Catatan Setiap WS_METADATA_ENDPOINT yang dikembalikan dari WsGetMetadataEndpoints berisi objek kebijakan.

[in] alternativeIndex

Menentukan indeks berbasis nol yang mengidentifikasi alternatif untuk digunakan dalam objek kebijakan. Jumlah alternatif yang ada dalam objek kebijakan dapat diperoleh menggunakan WsGetPolicyAlternativeCount.

[in] policyConstraints

Penunjuk ke batasan yang menentukan kebijakan yang akan dicocokkan bersama dengan bidang yang akan diisi jika fungsi mengembalikan NOERROR.

Catatan Jika batasan properti tidak ditentukan, nilai batasan default untuk properti tertentu digunakan.

Lihat WS_POLICY_CONSTRAINTS untuk informasi selengkapnya.

[in] matchRequired

Menunjukkan apakah kecocokan diperlukan atau tidak.

Catatan Jika nilaiNYA FALSE , kecocokan tidak diperlukan, dan bersama dengan alternatif kebijakan yang tidak cocok, fungsi akan mengembalikan S_FALSE.

Jika nilai parameter ini TRUE , kecocokan diperlukan, dan jika kebijakan tidak cocok, fungsi mengembalikan kesalahan.

[in] heap

Penunjuk ke objek Heap yang digunakan untuk menyimpan data apa pun yang memerlukan alokasi di luar batasan yang ditentukan.

Catatan Misalnya jenis pointer dalam bidang "out" batasan dialokasikan menggunakan Heap ini.

[in, optional] error

Penunjuk ke objek WS_ERROR tempat informasi tambahan tentang kesalahan harus disimpan jika fungsi gagal.

Mengembalikan nilai

Fungsi ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
WS_E_INVALID_FORMAT	Alternatif kebijakan tidak memenuhi batasan yang ditentukan dan matchRequired diatur ke TRUE. Kebijakan atau metadata lainnya dalam format yang tidak valid.
S_FALSE	Alternatif kebijakan tidak memenuhi batasan yang ditentukan dan matchRequired diatur ke FALSE.
S_OK	Alternatif kebijakan memenuhi batasan tertentu. Bidang keluar dari struktur batasan telah diisi dengan nilai dari kebijakan.

Keterangan

Masing-masing jenis data ini berisi bidang struct yang disebut "out".

Konten bidang keluar dari struktur ini diisi oleh fungsi ini jika panggilan mengembalikan NOERROR.

Catatan Jika panggilan fungsi gagal, konten mungkin telah diatur sebagian dan hanya beberapa alokasi yang mungkin telah dibuat dari objek heap yang ditentukan. Konten bidang keluar tidak boleh diperiksa kecuali fungsi mengembalikan NOERROR.

Objek kebijakan dapat menunda beberapa pemrosesan hingga fungsi ini dipanggil. Jika pemrosesan gagal, objek kebijakan diatur ke WS_POLICY_STATE_FAULTED.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	webservices.h
Pustaka	WebServices.lib
DLL	WebServices.dll

Bagikan melalui