Fungsi AllocCountedString

Artikel
06/13/2023

Catatan

Platform Perlindungan Akses Jaringan tidak tersedia dimulai dengan Windows 10

Fungsi AllocCountedString mengalokasikan memori untuk string yang dihentikan null dan mengembalikannya dalam struktur CountedString .

Sintaks

NAPAPI HRESULT WINAPI AllocCountedString(
  _Inout_       CountedString **countedString,
  _In_    const WCHAR         *string
);

Parameter

countedString [in, out]: Penunjuk ke alamat struktur CountedString yang baru dialokasikan.
string [in]: Penunjuk ke string yang dihentikan null yang akan dikembalikan dalam countedString.

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

FreeCountedString

Bagikan melalui