Fungsi AllocConnections

Artikel
06/13/2023

Catatan

Platform Perlindungan Akses Jaringan tidak tersedia dimulai dengan Windows 10

Fungsi AllocConnections mengalokasikan memori untuk sejumlah struktur Koneksi tertentu.

Sintaks

NAPAPI HRESULT WINAPI AllocConnections(
  _Inout_ Connections **connections,
  _In_    UINT16      connectionsCount
);

Parameter

connections [in, out]: Penunjuk ke array struktur Koneksi yang baru dialokasikan.
connectionsCount [in]: Jumlah struktur yang akan dialokasikan ke koneksi.

Nilai kembali

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil diselesaikan.
E_INVALIDARG	Argumen yang tidak valid telah diteruskan.
E_OUTOFMEMORY	Sistem kehabisan memori virtual. Operasi ini gagal.

Keterangan

Semua antarmuka COM yang didukung oleh sistem NAP menggunakan aturan manajemen memori COM standar dan alokator memori COM (CoTaskMemAlloc dan CoTaskMemFree):

Dalam parameter dialokasikan dan dibebaskan oleh pemanggil.
Parameter keluar dialokasikan oleh penerima panggilan dan dibebaskan oleh pemanggil menggunakan CoTaskMem.
Parameter masuk/keluar dialokasikan oleh pemanggil, dibebaskan dan dialokasikan kembali oleh penerima panggilan, dan pada akhirnya dibebaskan oleh pemanggil, menggunakan CoTaskMem.

Semua fungsi NAP untuk membebaskan memori juga membebaskan semua pointer yang disematkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	NapUtil.h
DLL	Qutil.dll

Lihat juga

FreeConnections

Bagikan melalui