AssociateContextWithName, fonction (filehc.h)

Article
08/23/2023

Insère un nom dans le cache de noms pour rechercher une structure de FIO_CONTEXT spécifiée.

Syntaxe

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

Paramètres

[in] pNameCache

Pointeur vers le nom du cache à utiliser.

[in] lpbName

Octets spécifiés par l’utilisateur pour le nom de l’élément de cache.

[in] cbName

Longueur du nom affecté à l’élément de cache.

[in] lpbData

Octets spécifiés par l’utilisateur pour toutes les données arbitraires à associer au nom de l’élément de cache.

[in] cbData

Longueur, en octets, des données arbitraires à associer au nom.

[in] pGenericMapping

Pointeur vers une structure GENERIC_MAPPING à associer au nom.

[in] pSecurityDescriptor

Descripteur de sécurité auto-relatif à associer au nom. Ce descripteur est fourni par l’utilisateur.

[in] pContext

Pointeur vers une structure FIO_CONTEXT .

[in] fKeepReference

Spécifie si la référence sur la structure FIO_CONTEXT doit être conservée. Si la valeur est TRUE, la référence est conservée.

Valeur retournée

Retourne TRUE si la fonction réussit ; sinon, elle retourne FALSE.

Notes

Si le nom est déjà présent dans le cache, cet appel échoue et GetLastError retourne ERROR_DUP_NAME.

Spécifications


Plateforme cible	Windows
En-tête	filehc.h
Bibliothèque	Fcachdll.lib
DLL	Fcachdll.dll

Voir aussi

FIO_CONTEXT

GENERIC_MAPPING

Partager via