Función AssociateContextWithName (filehc.h)

Inserta un nombre en la memoria caché de nombres para buscar una estructura de FIO_CONTEXT especificada.

Sintaxis

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

Parámetros

[in] pNameCache

Puntero al nombre de la memoria caché que se va a usar.

[in] lpbName

Bytes especificados por el usuario para el nombre del elemento de caché.

[in] cbName

Longitud del nombre que se asigna al elemento de caché.

[in] lpbData

Bytes especificados por el usuario para cualquier dato arbitrario que se asocie con el nombre del elemento de caché.

[in] cbData

Longitud, en bytes, de datos arbitrarios que se van a asociar al nombre.

[in] pGenericMapping

Puntero a una estructura de GENERIC_MAPPING que se va a asociar con el nombre.

[in] pSecurityDescriptor

Descriptor de seguridad auto relativo que se va a asociar con el nombre. El usuario proporciona este descriptor.

[in] pContext

Puntero a una estructura de FIO_CONTEXT .

[in] fKeepReference

Especifica si se debe mantener la referencia en la estructura FIO_CONTEXT . Si se establece en TRUE, se mantiene la referencia.

Valor devuelto

Devuelve TRUE si la función se realiza correctamente; de lo contrario, devuelve FALSE.

Comentarios

Si el nombre ya está presente en la memoria caché, se produce un error en esta llamada y GetLastError devuelve ERROR_DUP_NAME.

Requisitos

Plataforma de destino	Windows
Encabezado	filehc.h
Library	Fcachdll.lib
Archivo DLL	Fcachdll.dll

Consulte también

FIO_CONTEXT

GENERIC_MAPPING