IPortableDeviceManager::GetDeviceFriendlyName 메서드(portabledeviceapi.h)
디바이스의 사용자에게 친숙한 이름을 검색합니다.
구문
HRESULT GetDeviceFriendlyName(
[in] LPCWSTR pszPnPDeviceID,
[in, out] WCHAR *pDeviceFriendlyName,
[in, out] DWORD *pcchDeviceFriendlyName
);
매개 변수
[in] pszPnPDeviceID
디바이스의 플러그 앤 플레이 ID를 포함하는 null로 끝나는 문자열에 대한 포인터입니다. GetDevices를 호출하여 컴퓨터에 연결된 모든 디바이스의 플러그 앤 플레이 이름 목록을 검색할 수 있습니다.
[in, out] pDeviceFriendlyName
디바이스에 대한 사용자에게 친숙한 이름을 보유하는 데 사용되는 호출자 할당 버퍼입니다. 이 매개 변수에 필요한 크기를 알아보려면 먼저 이 매개 변수를 NULL 로 설정하고 pcchDeviceFriendlyName 을 0으로 설정하여 이 메서드를 호출합니다. 메서드가 성공하고 pcchDeviceFriendlyName 을 필수 버퍼 크기로 설정하여 종료 문자를 포함하여 디바이스 친화적인 이름을 보유합니다.
[in, out] pcchDeviceFriendlyName
입력에서 종료 문자를 포함하여 pDeviceFriendlyName 이 보유할 수 있는 최대 문자 수입니다. 출력에서 종료 문자를 포함하여 pDeviceFriendlyName에서 반환되는 문자 수입니다.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
반환 코드 | 설명 |
---|---|
|
제공된 버퍼가 디바이스 설명을 저장할 만큼 크지 않습니다. (필요한 크기는 pcchDeviceDescription 에서 반환된 값을 참조하세요.) |
|
디바이스 설명을 찾을 수 없습니다. |
|
메서드가 성공했습니다. |
|
필요한 인수 중 하나 이상이 NULL 포인터였습니다. |
설명
이 메서드를 지원하기 위해 디바이스가 필요하지 않습니다. 이 메서드가 이름을 검색하지 못하면 디바이스 개체의 WPD_OBJECT_NAME 속성(ID가 WPD_DEVICE_OBJECT_ID 개체)을 요청해 보세요.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | Windows |
헤더 | portabledeviceapi.h |
라이브러리 | PortableDeviceGUIDs.lib |