Fonction FindSyncContextFromName (filehc.h)

Article
02/26/2024

Récupère la structure FIO_CONTEXT associée au nom d’utilisateur spécifié.

Syntaxe

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

Paramètres

[in] pNameCache

Pointeur vers le cache de noms que le client doit utiliser.

[in] lpbName

Pointeur vers le nom de l’élément mis en cache.

[in] cbName

Taille, en octets, de la valeur dans lpbName.

[in] pfnCallback

Pointeur vers une fonction FCACHE_READ_CALLBACK .

Note Si ce paramètre a la valeur NULL, aucune fonction de rappel n’est appelée.

[in] lpvClientContext

Pointeur vers le contexte associé au client. Ce contexte est passé à la fonction de rappel.

[in] hToken

Demandez au cache d’évaluer le descripteur de sécurité incorporé. Si hToken est égal à zéro, il est ignoré.

[in] accessMask

Données de descripteur de sécurité. Pour plus d’informations, consultez ACCESS_MASK.

[out] ppContext

Pointeur vers un pointeur vers la structure FIO_CONTEXT associée au nom d’utilisateur.

Si la fonction retourne TRUE, ce paramètre peut renvoyer un pointeur NULL . Cela se produit lorsque l’utilisateur transmet une FIO_CONTEXT NULL à _AssociateContextWithName.