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 |