Fungsi RxSetSrvCallDomainName (rxprocs.h)

  • Artikel

RxSetSrvCallDomainName dipanggil oleh driver pengalih mini jaringan untuk mengatur nama domain yang terkait dengan server tertentu (struktur SRV_CALL).

Sintaks

NTSTATUS RxSetSrvCallDomainName(
  [in] IN PMRX_SRV_CALL   SrvCall,
  [in] IN PUNICODE_STRING DomainName
);

Parameter

[in] SrvCall

Penunjuk ke struktur SRV_CALL.

[in] DomainName

Penunjuk ke buffer yang berisi string Unicode yang dihentikan nol yang menamai domain tempat server ini berada.

Nilai kembali

RxSetSrvCallDomainName mengembalikan STATUS_SUCCESS pada keberhasilan atau salah satu nilai kesalahan berikut pada kegagalan:

Menampilkan kode Deskripsi
STATUS_INSUFFICIENT_RESOURCES
 Tidak ada cukup sumber daya untuk menyelesaikan rutinitas ini. Permintaan alokasi memori gagal untuk memori kumpulan yang tidak disebarkan untuk menyimpan nama domain baru.

Keterangan

Nama domain mungkin tidak diketahui di awal permintaan pengalihan jaringan. Rutinitas RxSetSrvCallDomainName memungkinkan nama domain dikaitkan dengan SrvCall setelah diketahui. Rutinitas ini biasanya akan digunakan sebagai bagian dari pembuatan dan inisialisasi struktur SRV_CALL.

Jika nama domain sudah dikaitkan dengan parameter SrvCall , maka nama domain ini akan dihapus dan memori yang terkait dengan entri ini di SrvCall akan dibebaskan.

Jika parameter DomainName bukan penunjuk NULL , dan parameter DomainName memiliki panjang yang lebih besar dari nol, maka RxSetSrvCallDomainName mengalokasikan ruang untuk anggota pDomainNameSrvCall dari kumpulan yang tidak disebarkan dengan tag kumpulan RX_SRVCALL_PARAMS_POOLTAG. RxSetSrvCallDomainName rutin mengatur anggota buffer, panjang, dan MaximumLength dari struktur pDomainName.

Persyaratan

Persyaratan Nilai
Target Platform Desktop
Header rxprocs.h (termasuk Mrxfcb.h, Rxprocs.h)
IRQL <= APC_LEVEL

Lihat juga

RxCreateSrvCall

RxFinalizeSrvCall