Metode IUPnPServiceAsync::EndQueryStateVariable (upnp.h)

Artikel
08/26/2023

Metode EndQueryStateVariable mengambil hasil operasi BeginQueryStateVariable sebelumnya dan mengambil nilai variabel status khusus layanan yang dihasilkan.

Sintaks

HRESULT EndQueryStateVariable(
  [in]          ULONG64 ullRequestID,
  [out, retval] VARIANT *pValue
);

Parameter

[in] ullRequestID

Penunjuk ke nilai ULONG 64-bit yang sesuai dengan operasi BeginQueryStateVariable yang dimulai sebelum panggilan ini.

[out, retval] pValue

Pada input, berisi array kosong. Pada output, menerima referensi ke nilai variabel yang ditentukan dalam BeginQueryStateVariable oleh bstrVariableName. Jenis data yang dikembalikan tergantung pada variabel status tempat kueri dipanggil.

Catatan Hapus parameter ini dengan VariantClear.

Menampilkan nilai

Mengembalikan S_OK pada keberhasilan. Jika tidak, metode mengembalikan kode kesalahan COM yang ditentukan dalam WinError.h atau salah satu nilai berikut:

Menampilkan kode	Deskripsi
UPNP_E_DEVICE_ERROR	Variabel status tidak dimuat dan kueri jarak jauh mengembalikan kode kesalahan. Ini bukan kesalahan transportasi; perangkat menerima permintaan, tetapi mengembalikan kesalahan.
UPNP_E_INVALID_VARIABLE	Variabel status yang diminta tidak ada.
UPNP_E_DEVICE_TIMEOUT	Perangkat belum merespons dalam periode waktu habis 30 detik.
UPNP_E_INVALID_ARGUMENTS	Satu atau beberapa argumen yang diteruskan dengan vInActionArgs tidak valid.
UPNP_E_PROTOCOL_ERROR	Kueri tidak selesai karena masalah pada tingkat protokol UPnP.
UPNP_E_TRANSPORT_ERROR	Variabel status tidak terjadi dan kueri jarak jauh untuk nilai gagal karena masalah HTTP. Untuk mengambil kode kesalahan HTTP, gunakan IUPnPService::LastTransportStatus.
UPNP_E_VARIABLE_VALUE_UNKNOWN	Variabel status terjadi, tetapi perangkat lunak UPnP tidak dapat mengembalikan nilai karena masih menunggu pemberitahuan peristiwa.

Catatan Beberapa nilai dapat menunjukkan bahwa kesalahan diterima dari perangkat bersertifikat UPnP. Untuk informasi selengkapnya, lihat Kode Kesalahan Perangkat.

Persyaratan


Klien minimum yang didukung	Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	upnp.h
DLL	Upnp.dll

Lihat juga

IUPnPService::LastTransportStatus

IUPnPServiceAsync

IUPnPServiceAsync::EndQueryStateVariable

Bagikan melalui