PrjFillDirEntryBuffer-Funktion (projectedfslib.h)

Artikel
03/01/2024

Stellt Informationen für eine Datei oder ein Verzeichnis für eine Enumeration bereit.

Syntax

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

Parameter

[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] dirEntryBufferHandle

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

Rückgabewert

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

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.

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.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10, Version 1809 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	projectedfslib.h

Freigeben über