Функция FindSyncContextFromName (filehc.h)

Статья
08/23/2023

Извлекает структуру 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 . Это происходит, когда пользователь передает FIO_CONTEXT NULLв _AssociateContextWithName.