PrjFillDirEntryBuffer2-Funktion (projectedfslib.h)

Artikel
10/10/2023

Stellt Informationen für eine Datei oder ein Verzeichnis für eine Enumeration bereit und ermöglicht es dem Aufrufer, erweiterte Informationen anzugeben.

Syntax

HRESULT PrjFillDirEntryBuffer2(
  [in]           PRJ_DIR_ENTRY_BUFFER_HANDLE dirEntryBufferHandle,
  [in]           PCWSTR                      fileName,
  [in, optional] PRJ_FILE_BASIC_INFO         *fileBasicInfo,
  [in, optional] PRJ_EXTENDED_INFO           *extendedInfo
);

Parameter

[in] dirEntryBufferHandle

Ein undurchsichtiges Handle für eine Struktur, die Informationen zu den ausgefüllten Einträgen empfängt.

[in] fileName

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Namen des Eintrags enthält.

[in, optional] fileBasicInfo

Grundlegende Informationen zum auszufüllenden Eintrag.

[in, optional] extendedInfo

Ein Zeiger auf eine PRJ_EXTENDED_INFO Struktur, die erweiterte Informationen zum auszufüllenden Eintrag angibt.

Rückgabewert

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) gibt an, dass dirEntryBufferHandle nicht genügend Platz für den neuen Eintrag hat.

E_INVALIDARG gibt an, dass extendedInfo.InfoType nicht erkannt wird.

Hinweise

Der Anbieter verwendet diese Routine, um einen PRJ_GET_DIRECTORY_ENUMERATION_CB Rückruf zu verarbeiten. Bei der Verarbeitung des Rückrufs ruft der Anbieter diese Routine für jede übereinstimmende Datei oder jedes verzeichnis in der Enumeration auf. Mit dieser Routine kann der Anbieter erweiterte Informationen zur Datei oder zum Verzeichnis angeben, z. B. ob es sich um einen symbolischen Link handelt.

Wenn diese Routine beim Hinzufügen eines Eintrags zur Enumeration HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) zurückgibt, gibt der Anbieter S_OK aus dem Rückruf zurück und wartet auf den nächsten PRJ_GET_DIRECTORY_ENUMERATION_CB Rückruf.

Der Anbieter setzt das Ausfüllen der Enumeration mit dem Eintrag fort, den er hinzufügen wollte, als er HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) erhalten hat.

Wenn diese Routine HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) für den ersten Eintrag zurückgibt, der beim Aufruf eines PRJ_GET_DIRECTORY_ENUMERATION_CB Rückrufs hinzugefügt wurde, muss der Anbieter HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) aus dem Rückruf zurückgeben.

Symbolische Links

Um anzugeben, dass dieser Verzeichniseintrag für einen symbolischen Link gilt, formatiert der Anbieter einen Puffer mit einer einzelnen PRJ_EXTENDED_INFO Struktur und übergibt im extendedInfo Parameter einen Zeiger darauf. Der Anbieter legt die Felder der Struktur wie folgt fest:

extendedInfo.InfoType = PRJ_EXT_INFO_TYPE_SYMLINK
extendedInfo.NextInfoOffset = 0
extendedInfo.Symlink.TargetName = <path to the target of the symbolic link>

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 2004 (10.0; Build 19041)
Unterstützte Mindestversion (Server)	Windows Server, Version 2004 (10.0; Build 19041)
Zielplattform	Windows
Kopfzeile	projectedfslib.h

Freigeben über