IDsDisplaySpecifier::GetIconLocation 메서드(dsclient.h)

IDsDisplaySpecifier::GetIconLocation 메서드는 지정된 개체 클래스의 아이콘 위치를 가져옵니다. 아이콘 위치에는 파일 이름 및 리소스 식별자가 포함됩니다.

구문

HRESULT GetIconLocation(
  [in]      LPCWSTR pszObjectClass,
  [in]      DWORD   dwFlags,
  [in, out] LPWSTR  pszBuffer,
  [in]      INT     cchBuffer,
  [in, out] INT     *presid
);

매개 변수

[in] pszObjectClass

아이콘 위치를 가져올 개체 클래스의 이름을 포함하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 개체 클래스 이름의 예로는 "user" 및 "container"가 있습니다.

[in] dwFlags

검색할 아이콘의 유형을 나타내는 플래그 집합을 포함합니다. 다음 중 하나 이상의 조합일 수 있습니다.

DSGIF_ISNORMAL

개체 클래스의 일반 아이콘을 가져옵니다.

DSGIF_ISOPEN

개체 클래스에 대해 열린 폴더와 같은 열린 아이콘을 가져옵니다. 개체 클래스에 열려 있는 아이콘이 없는 경우 이 메서드는 개체 클래스에 대한 일반 아이콘을 가져오려고 시도합니다.

DSGIF_ISDISABLED

개체 클래스에 대해 비활성화된 사용자와 같은 비활성화된 아이콘을 가져옵니다. 개체 클래스에 비활성화된 아이콘이 없는 경우 이 메서드는 개체 클래스에 대한 일반 아이콘을 가져오려고 시도합니다.

DSGIF_GETDEFAULTICON

개체 클래스에 대한 아이콘을 찾을 수 없는 경우 이 메서드는 기본 아이콘을 반환합니다. 이 플래그를 지정하지 않고 개체 클래스에 대한 아이콘을 찾을 수 없는 경우 이 메서드는 NULL을 반환합니다.

DSGIF_DEFAULTISCONTAINER

개체 클래스에 대한 아이콘을 찾을 수 없는 경우 이 메서드는 컨테이너 아이콘을 기본 아이콘으로 반환합니다. 이 플래그를 지정하지 않고 개체 클래스에 대한 아이콘을 찾을 수 없는 경우 이 메서드는 NULL을 반환합니다.

[in, out] pszBuffer

아이콘이 포함된 파일의 경로 및 파일 이름을 수신하는 와이드 문자 버퍼에 대한 포인터입니다. 이 버퍼의 길이는 cchBuffer 와이드 문자 이상이어야 합니다.

[in] cchBuffer

종료되는 NULL 문자를 포함하여 pszBuffer 버퍼의 크기를 와이드 문자로 포함합니다. 파일 이름이 이 문자 수를 초과하면 파일 이름이 잘립니다.

[in, out] presid

아이콘의 리소스 식별자 또는 인덱스를 수신하는 INT 값에 대한 포인터입니다. 이 값이 양수이면 해당 값은 파일의 아이콘 인덱스입니다. 이 값이 음수이면 이 값의 절대값은 파일에 있는 아이콘의 리소스 식별자입니다.

반환 값

다음을 포함하여 표준 HRESULT 값을 반환합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista
지원되는 최소 서버	Windows Server 2008
대상 플랫폼	Windows
헤더	dsclient.h
DLL	Dsadmin.dll

추가 정보

Active Directory Domain Services 인터페이스 표시

IDsDisplaySpecifier

IDsDisplaySpecifier::GetIcon