Funzione AssociateContextWithName (filehc.h)
Inserisce un nome nella cache dei nomi per trovare una struttura di FIO_CONTEXT specificata.
Sintassi
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
);
Parametri
[in] pNameCache
Puntatore al nome della cache da usare.
[in] lpbName
Byte specificati dall'utente per il nome dell'elemento della cache.
[in] cbName
Lunghezza del nome assegnato all'elemento della cache.
[in] lpbData
Byte specificati dall'utente per eventuali dati arbitrari da associare al nome dell'elemento della cache.
[in] cbData
Lunghezza, in byte, di dati arbitrari da associare al nome.
[in] pGenericMapping
Puntatore a una struttura GENERIC_MAPPING da associare al nome.
[in] pSecurityDescriptor
Descrittore di sicurezza self-relativo da associare al nome. Questo descrittore viene fornito dall'utente.
[in] pContext
Puntatore a una struttura FIO_CONTEXT .
[in] fKeepReference
Specifica se il riferimento nella struttura FIO_CONTEXT deve essere mantenuto. Se impostato su TRUE, il riferimento viene mantenuto.
Valore restituito
Restituisce TRUE se la funzione ha esito positivo; in caso contrario, restituisce FALSE.
Commenti
Se il nome è già presente nella cache, questa chiamata ha esito negativo e GetLastError restituisce ERROR_DUP_NAME.
Requisiti
| Piattaforma di destinazione | Windows |
| Intestazione | filehc.h |
| Libreria | Fcachdll.lib |
| DLL | Fcachdll.dll |