IPortableDeviceManager::GetDeviceDescription 메서드(portabledeviceapi.h)

디바이스에 대한 설명을 검색합니다.

구문

HRESULT GetDeviceDescription(
  [in]      LPCWSTR pszPnPDeviceID,
  [in, out] WCHAR   *pDeviceDescription,
  [in, out] DWORD   *pcchDeviceDescription
);

매개 변수

[in] pszPnPDeviceID

디바이스의 플러그 앤 플레이 ID를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. GetDevices를 호출하여 현재 연결된 디바이스의 플러그 앤 플레이 이름 목록을 검색할 수 있습니다.

[in, out] pDeviceDescription

디바이스의 사용자 설명 이름을 저장할 호출자가 할당한 버퍼입니다. 호출자는 이 매개 변수에 대한 메모리를 할당해야 합니다. 이 매개 변수에 필요한 크기를 알아보려면 먼저 이 매개 변수를 NULL 로 설정하고 pcchDeviceDescription 을 0으로 설정하여 이 메서드를 호출합니다. 메서드가 성공하고 pcchDeviceDescription 을 필수 버퍼 크기로 설정하여 종료 문자를 포함하여 디바이스에 친숙한 이름을 저장합니다.

[in, out] pcchDeviceDescription

pDeviceDescription의 문자 수(종료 문자 포함 안 됨)입니다. 입력에서 pDeviceDescription의 최대 길이입니다. 출력에서 pDeviceDescription에서 반환된 문자열의 길이입니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	설명
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	제공된 버퍼가 디바이스 설명을 저장할 만큼 크지 않습니다. (필요한 크기는 pcchDeviceDescription 에서 반환된 값을 참조하세요.)
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)	디바이스 설명을 찾을 수 없습니다.
S_OK	메서드가 성공했습니다.
E_POINTER	필요한 인수 중 하나 이상이 NULL 포인터였습니다.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	portabledeviceapi.h
라이브러리	PortableDeviceGUIDs.lib

추가 정보

GetDevices

IPortableDeviceManager 인터페이스