AssociateCoNtextWithName 函式 (filehc.h)

將名稱插入名稱快取中，以尋找指定的 FIO_CONTEXT 結構。

語法

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
);

參數

[in] pNameCache

要使用之快取名稱的指標。

[in] lpbName

快取專案名稱的使用者指定位元組。

[in] cbName

指派給快取專案的名稱長度。

[in] lpbData

任何要與快取專案名稱建立關聯的任意資料的使用者指定位元組。

[in] cbData

要與名稱產生關聯的任意資料的長度，以位元組為單位。

[in] pGenericMapping

要與名稱產生關聯的 GENERIC_MAPPING 結構的指標。

[in] pSecurityDescriptor

要與名稱相關聯的自我相對安全性描述元。 此描述項是由使用者提供。

[in] pContext

FIO_CONTEXT結構的指標。

[in] fKeepReference

指定是否應保留 FIO_CONTEXT 結構的參考。 如果設定為 TRUE，則會保留參考。

傳回值

如果函式成功，則傳回 TRUE ;否則會傳回 FALSE。

備註

如果快取中已經有名稱，則此呼叫會失敗，而且 GetLastError 會傳回ERROR_DUP_NAME。

需求

目標平台	Windows
標頭	filehc.h
程式庫	Fcachdll.lib
Dll	Fcachdll.dll

另請參閱

FIO_CONTEXT

GENERIC_MAPPING