PrjFillDirEntryBuffer2 함수(projectedfslib.h)

하나의 파일 또는 디렉터리에 대한 정보를 열거형에 제공하고 호출자가 확장 정보를 지정할 수 있도록 합니다.

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

매개 변수

[in] dirEntryBufferHandle

채워진 항목에 대한 정보를 받는 구조체에 대한 불투명 핸들입니다.

[in] fileName

항목의 이름을 포함하는 null로 끝나는 문자열에 대한 포인터입니다.

[in, optional] fileBasicInfo

채울 항목에 대한 기본 정보입니다.

[in, optional] extendedInfo

채울 항목에 대한 확장 정보를 지정하는 PRJ_EXTENDED_INFO 구조체에 대한 포인터입니다.

반환 값

HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)는 dirEntryBufferHandle에 새 항목에 충분한 공간이 없음을 나타냅니다.

E_INVALIDARG extendedInfo.InfoType을 인식할 수 없음을 나타냅니다.

비고

공급자는 이 루틴을 사용하여 PRJ_GET_DIRECTORY_ENUMERATION_CB 콜백을 서비스합니다. 콜백을 처리할 때 공급자는 열거형의 일치하는 각 파일 또는 디렉터리에 대해 이 루틴을 호출합니다. 이 루틴을 사용하면 공급자가 파일 또는 디렉터리에 대한 확장된 정보(예: 기호 링크인지 여부)를 지정할 수 있습니다.

이 루틴이 열거형에 항목을 추가할 때 HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)를 반환하는 경우 공급자는 콜백에서 S_OK 반환하고 다음 PRJ_GET_DIRECTORY_ENUMERATION_CB 콜백을 기다립니다.

공급자가 HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)를 얻었을 때 추가하려는 항목으로 열거를 다시 시작합니다.

이 루틴이 PRJ_GET_DIRECTORY_ENUMERATION_CB 콜백을 호출하는 동안 추가된 첫 번째 항목에 대한 HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER )를 반환하는 경우 공급자는 콜백에서 HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)를 반환해야 합니다.

기호 링크

이 디렉터리 항목이 기호 링크용임을 지정하기 위해 공급자는 단일 PRJ_EXTENDED_INFO 구조체로 버퍼의 형식을 지정하고 매개 변수에 extendedInfo 포인터를 전달합니다. 공급자는 다음과 같이 구조체의 필드를 설정합니다.

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

요구 사항