Fungsi ResUtilGetEnvironmentWithNetName (resapi.h)
Menyesuaikan data lingkungan untuk sumber daya sehingga sumber daya menggunakan nama jaringan kluster untuk mengidentifikasi lokasinya. Sumber daya harus bergantung pada sumber daya Nama Jaringan . Jenis PRESUTIL_GET_ENVIRONMENT_WITH_NET_NAME mendefinisikan penunjuk ke fungsi ini.
Sintaks
LPVOID ResUtilGetEnvironmentWithNetName(
[in] HRESOURCE hResource
);
Parameter
[in] hResource
Tangani ke sumber daya yang bergantung pada sumber daya Nama Jaringan.
Nilai kembali
Jika operasi berhasil, fungsi mengembalikan penunjuk ke blok lingkungan.
Jika operasi gagal, fungsi mengembalikan NULL. Untuk informasi selengkapnya, hubungi GetLastError.
Keterangan
Fungsi ResUtilGetEnvironmentWithNetName menambahkan variabel lingkungan ke blok lingkungan saat ini. Lewati blok lingkungan yang dikembalikan ke CreateProcess saat memulai sumber daya untuk mencapai efek berikut:
- Klien dan kluster dapat menemukan sumber daya dengan menggunakan nama sumber daya Nama Jaringan.
- Jika sumber daya memanggil GetComputerName, GetComputerNameEx, atau gethostbyname, nama jaringan akan ditampilkan terlepas dari simpul mana yang saat ini menghosting sumber daya.
Gunakan ResUtilFreeEnvironment untuk menghancurkan blok lingkungan.
Jangan panggil ResUtilGetEnvironmentWithNetName dari fungsi titik entri DLL sumber daya apa pun. ResUtilGetEnvironmentWithNetName dapat dengan aman dipanggil dari utas pekerja. Untuk informasi selengkapnya, lihat Panggilan Fungsi untuk Dihindari di DLL Sumber Daya.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tidak ada yang didukung |
| Server minimum yang didukung | Pusat Data Windows Server 2008 Enterprise, Windows Server 2008 |
| Target Platform | Windows |
| Header | resapi.h |
| Pustaka | ResUtils.lib |
| DLL | ResUtils.dll |