SHGetAttributesFromDataObject 함수(shlobj_core.h)

[SHGetAttributesFromDataObject 는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다.]

시스템 데이터 개체에서 지정된 정보를 검색합니다.

구문

HRESULT SHGetAttributesFromDataObject(
  [in, optional]  IDataObject *pdo,
                  DWORD       dwAttributeMask,
  [out, optional] DWORD       *pdwAttributes,
  [out, optional] UINT        *pcItems
);

매개 변수

[in, optional] pdo

형식: IDataObject*

정보를 검색할 데이터 개체입니다.

dwAttributeMask

형식:DWORD

호출하는 애플리케이션이 검색하려는 정보를 나타내는 하나 이상의 SFGAO 플래그입니다.

[out, optional] pdwAttributes

형식: DWORD*

이 함수가 성공적으로 반환될 때 pdo의 모든 항목에 공통적인 특성을 나타내는 하나 이상의 SFGAO 플래그를 수신하는 DWORD 값에 대한 포인터입니다. 이 정보가 필요하지 않은 경우 이 포인터는 NULL 일 수 있습니다.

[out, optional] pcItems

형식: UINT*

이 함수가 성공적으로 반환될 때 pdo가 가리키는 데이터 개체의 PIDL 수를 수신하는 UINT에 대한 포인터입니다. 이 정보가 필요하지 않은 경우 이 포인터는 NULL 일 수 있습니다.

반환 값

형식: HRESULT

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	성공.
S_FALSE	개체가 시스템 데이터 개체가 아닙니다. 이 경우 pdwAttributes 는 0으로 설정됩니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shlobj_core.h(Shlobj.h 포함)
라이브러리	Shell32.lib
DLL	Shell32.dll(버전 6.0 이상)