Fungsi AssociateContextWithName (filehc.h)

Sisipkan nama ke dalam cache nama untuk menemukan struktur FIO_CONTEXT tertentu.

Sintaks

FILEHC_EXPORT BOOL AssociateContextWithName(
  [in] PNAME_CACHE_CONTEXT  pNameCache,
  [in] LPBYTE               lpbName,
  [in] DWORD                cbName,
  [in] LPBYTE               lpbData,
  [in] DWORD                cbData,
  [in] PGENERIC_MAPPING     pGenericMapping,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in] FIO_CONTEXT          *pContext,
  [in] BOOL                 fKeepReference
);

Parameter

[in] pNameCache

Penunjuk ke nama cache yang akan digunakan.

[in] lpbName

Byte yang ditentukan pengguna untuk nama item cache.

[in] cbName

Panjang nama yang ditetapkan ke item cache.

[in] lpbData

Byte yang ditentukan pengguna untuk data arbitrer apa pun untuk dikaitkan dengan nama item cache.

[in] cbData

Panjangnya, dalam byte, dari data arbitrer untuk dikaitkan dengan nama.

[in] pGenericMapping

Penunjuk ke struktur GENERIC_MAPPING untuk dikaitkan dengan nama.

[in] pSecurityDescriptor

Deskriptor keamanan relatif mandiri yang akan dikaitkan dengan nama tersebut. Deskriptor ini disediakan oleh pengguna.

[in] pContext

Penunjuk ke struktur FIO_CONTEXT .

[in] fKeepReference

Menentukan apakah referensi pada struktur FIO_CONTEXT harus disimpan. Jika diatur ke TRUE, referensi akan disimpan.

Menampilkan nilai

Mengembalikan TRUE jika fungsi berhasil; jika tidak, ia mengembalikan FALSE.

Keterangan

Jika nama sudah ada di cache, panggilan ini gagal dan GetLastError mengembalikan ERROR_DUP_NAME.

Persyaratan

Target Platform	Windows
Header	filehc.h
Pustaka	Fcachdll.lib
DLL	Fcachdll.dll

Lihat juga

FIO_CONTEXT

GENERIC_MAPPING