Función FindSyncContextFromName (filehc.h)

Artículo
08/23/2023

Recupera la estructura FIO_CONTEXT asociada al nombre de usuario especificado.

Sintaxis

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

Parámetros

[in] pNameCache

Puntero a la memoria caché de nombres que va a usar el cliente.

[in] lpbName

Puntero al nombre del elemento almacenado en caché.

[in] cbName

Tamaño, en bytes, del valor en lpbName.

[in] pfnCallback

Puntero a una función de FCACHE_READ_CALLBACK .

Nota Si este parámetro es NULL, no se llama a ninguna función de devolución de llamada.

[in] lpvClientContext

Puntero al contexto asociado al cliente. Este contexto se pasa a la función de devolución de llamada.

[in] hToken

Solicite la memoria caché para evaluar el descriptor de seguridad insertado. Si hToken es cero, se omite.

[in] accessMask

Datos del descriptor de seguridad. Para obtener más información, consulte ACCESS_MASK.

[out] ppContext

Puntero a un puntero a la estructura de FIO_CONTEXT asociada al nombre de usuario.

Si la función devuelve TRUE, este parámetro puede devolver un puntero NULL . Esto ocurre cuando el usuario pasa un FIO_CONTEXT NULL a _AssociateContextWithName.