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 |