AssociateContextWithName-Funktion (filehc.h)

Fügt einen Namen in den Namenscache ein, um eine angegebene FIO_CONTEXT Struktur zu finden.

Syntax

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

Parameter

[in] pNameCache

Ein Zeiger auf den Namen des zu verwendenden Caches.

[in] lpbName

Benutzerdefinierte Bytes für den Namen des Cacheelements.

[in] cbName

Die Länge des Namens, der dem Cacheelement zugewiesen ist.

[in] lpbData

Benutzerdefinierte Bytes für beliebige Daten, die dem Namen des Cacheelements zugeordnet werden sollen.

[in] cbData

Die Länge beliebiger Daten, die dem Namen zugeordnet werden sollen, in Bytes.

[in] pGenericMapping

Ein Zeiger auf eine GENERIC_MAPPING Struktur, die dem Namen zugeordnet werden soll.

[in] pSecurityDescriptor

Der selbstrelative Sicherheitsdeskriptor, der dem Namen zugeordnet werden soll. Dieser Deskriptor wird vom Benutzer bereitgestellt.

[in] pContext

Ein Zeiger auf eine FIO_CONTEXT Struktur.

[in] fKeepReference

Gibt an, ob der Verweis auf die FIO_CONTEXT-Struktur beibehalten werden soll. Wenn auf TRUE festgelegt ist, wird der Verweis beibehalten.

Rückgabewert

Gibt TRUE zurück, wenn die Funktion erfolgreich ist. Andernfalls wird FALSE zurückgegeben.

Hinweise

Wenn der Name bereits im Cache vorhanden ist, schlägt dieser Aufruf fehl, und GetLastError gibt ERROR_DUP_NAME zurück.

Anforderungen

Weitere Informationen

FIO_CONTEXT

GENERIC_MAPPING