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

Vedi anche

FIO_CONTEXT

GENERIC_MAPPING