FindSyncContextFromName-Funktion (filehc.h)

Artikel
02/29/2024

Ruft die FIO_CONTEXT-Struktur ab, die dem angegebenen Benutzernamen zugeordnet ist.

Syntax

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

Parameter

[in] pNameCache

Ein Zeiger auf den Namencache, den der Client verwenden soll.

[in] lpbName

Ein Zeiger auf den Namen des zwischengespeicherten Elements.

[in] cbName

Die Größe des Werts in lpbName in Bytes.

[in] pfnCallback

Ein Zeiger auf eine FCACHE_READ_CALLBACK-Funktion .

Hinweis Wenn dieser Parameter NULL ist, wird keine Rückruffunktion aufgerufen.

[in] lpvClientContext

Ein Zeiger auf den Kontext, der dem Client zugeordnet ist. Dieser Kontext wird an die Rückruffunktion übergeben.

[in] hToken

Fordern Sie den Cache an, um die eingebettete Sicherheitsbeschreibung auszuwerten. Wenn hToken 0 ist, wird es ignoriert.

[in] accessMask

Die Sicherheitsbeschreibungsdaten. Weitere Informationen finden Sie unter ACCESS_MASK.

[out] ppContext

Ein Zeiger auf einen Zeiger auf die FIO_CONTEXT Struktur, die dem Benutzernamen zugeordnet ist.

Wenn die Funktion TRUE zurückgibt, kann dieser Parameter einen NULL-Zeiger zurückgeben. Dies tritt auf, wenn der Benutzer eine NULL-FIO_CONTEXT an _AssociateContextWithName übergibt.