PrjFillDirEntryBuffer-Funktion (projectedfslib.h)

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

Die Parameter

[in] fileName

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die den Namen des Eintrags enthält.

[in, optional] fileBasicInfo

Grundlegende Informationen zum zu fü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.

Bemerkungen

Der Anbieter verwendet diese Routine, um einen PRJ_GET_DIRECTORY_ENUMERATION_CB Rückruf zu verarbeiten. Beim Verarbeiten 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 während eines Aufrufs 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