FindSyncContextFromName 函式 (filehc.h)
擷取與指定之使用者名稱相關聯的 FIO_CONTEXT 結構。
語法
FILEHC_EXPORT BOOL FindSyncContextFromName(
[in] PNAME_CACHE_CONTEXT pNameCache,
[in] LPBYTE lpbName,
[in] DWORD cbName,
[in] CACHE_READ_CALLBACK pfnCallback,
[in] LPVOID lpvClientContext,
[in] HANDLE hToken,
[in] ACCESS_MASK accessMask,
[out] FIO_CONTEXT **ppContext
);
參數
[in] pNameCache
用戶端要使用的名稱快取指標。
[in] lpbName
快取項目名稱的指標。
[in] cbName
lpbName 中值的大小，以位元組為單位。
[in] pfnCallback
FCACHE_READ_CALLBACK函式的指標。
注意 如果此參數為 NULL，則不會呼叫回呼函式。
[in] lpvClientContext
與客戶端相關聯的內容指標。 此內容會傳遞至回呼函式。
[in] hToken
要求快取評估內嵌的安全性描述元。 如果 hToken 為零，則會忽略它。
[in] accessMask
安全性描述項數據。 如需詳細資訊，請參閱 ACCESS_MASK。
[out] ppContext
與使用者名稱相關聯 之FIO_CONTEXT 結構的指標。
如果函式傳回 TRUE，此參數可以傳回 NULL 指標。 當使用者將 NULL FIO_CONTEXT傳遞至 _AssociateContextWithName時，就會發生這種情況。
傳回值
如果在快取中找到名稱，則傳回 TRUE ;否則會傳回 FALSE。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Windows |
| 標頭 | filehc.h |
| 程式庫 | Fcachdll.lib |
| Dll | Fcachdll.dll |