通过

associateContextWithName 函数 (filehc.h)

  • 项目

将名称插入到名称缓存中以查找指定的 FIO_CONTEXT 结构。

语法

FILEHC_EXPORT BOOL AssociateContextWithName(
  [in] PNAME_CACHE_CONTEXT  pNameCache,
  [in] LPBYTE               lpbName,
  [in] DWORD                cbName,
  [in] LPBYTE               lpbData,
  [in] DWORD                cbData,
  [in] PGENERIC_MAPPING     pGenericMapping,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in] FIO_CONTEXT          *pContext,
  [in] BOOL                 fKeepReference
);

参数

[in] pNameCache

指向要使用的缓存名称的指针。

[in] lpbName

缓存项名称的用户指定的字节。

[in] cbName

分配给缓存项的名称的长度。

[in] lpbData

要与缓存项的名称关联的任意数据的用户指定字节。

[in] cbData

要与名称关联的任意数据的长度（以字节为单位）。

[in] pGenericMapping

指向要与名称关联的 GENERIC_MAPPING 结构的指针。

[in] pSecurityDescriptor

要与名称关联的自相对安全描述符。 此描述符由用户提供。

[in] pContext

指向 FIO_CONTEXT 结构的指针。

[in] fKeepReference

指定是否应保留 FIO_CONTEXT 结构上的引用。 如果设置为 TRUE，则保留引用。

返回值

如果函数成功，则返回 TRUE ;否则返回 FALSE。

备注

如果缓存中已存在该名称，则此调用将失败， 并且 GetLastError 将返回ERROR_DUP_NAME。

要求

   
目标平台 Windows
标头 filehc.h
Library Fcachdll.lib
DLL Fcachdll.dll

请参阅

FIO_CONTEXT

GENERIC_MAPPING