FindSyncContextFromName function

Retrieves the FIO_CONTEXT structure that is associated with the specified user name.

Syntax

FILEHC_EXPORT BOOL FindSyncContextFromName(
  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
);

Parameters

pNameCache

A pointer to the name cache that the client is to use.

lpbName

A pointer to the name of the cached item.

cbName

The size, in bytes, of the value in lpbName.

pfnCallback

A pointer to a FCACHE_READ_CALLBACK function.

Note  If this parameter is NULL, no callback function is called.
 

lpvClientContext

A pointer to the context that is associated with the client. This context is passed to the callback function.

hToken

Request the cache to evaluate the embedded security descriptor. If hToken is zero, it is ignored.

accessMask

The security descriptor data. For more information, see ACCESS_MASK.

ppContext

A pointer to a pointer to the FIO_CONTEXT structure that is associated with the user name.

If the function returns TRUE, this parameter can return a NULL pointer. This occurs when the user passes a NULL FIO_CONTEXT to _AssociateContextWithName.

Return Value

Returns TRUE if the name is found in the cache; otherwise, it returns FALSE.

Requirements

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

See Also

ACCESS_MASK

AssociateContextWithName

FCACHE_READ_CALLBACK

FIO_CONTEXT