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 |
| Library | Fcachdll.lib |
| DLL | Fcachdll.dll |