IWMDeviceManager2::GetDeviceFromCanonicalName 메서드(mswmdm.h)

GetDeviceFromCanonicalName 메서드는 지정된 정식 이름을 가진 디바이스에 대한 IWMDMDevice 인터페이스를 검색합니다. IWMDMDevice2::GetCanonicalName을 호출하여 디바이스의 정식 이름을 검색할 수 있습니다.

구문

HRESULT GetDeviceFromCanonicalName(
  LPCWSTR     pwszCanonicalName,
  IWMDMDevice **ppDevice
);

매개 변수

pwszCanonicalName

디바이스의 정식 이름을 지정하는 null로 끝나는 와이드 문자열입니다.

ppDevice

지정된 정식 이름을 가진 디바이스 개체의 IWMDMDevice 인터페이스에 대한 포인터에 대한 포인터입니다. 호출자는 이 인터페이스가 완료되면 이 인터페이스를 해제해야 합니다.

반환 값

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

반환 코드	설명
E_INVALIDARG	pwszCanonicalName 또는 ppDeviceArray 매개 변수가 잘못되었거나 NULL 포인터입니다.
S_FALSE	정식 이름 pwszCanonicalName을 사용하여 연결된 디바이스를 찾을 수 없습니다.

설명

이 메서드는 애플리케이션이 IWMDMNotification을 구현하는 경우 유용할 수 있습니다. 그러면 디바이스가 컴퓨터에 연결되거나 연결이 끊어질 때 정식 이름 알림을 보냅니다.

요구 사항

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

추가 정보

IWMDMDevice2 인터페이스

IWMDeviceManager2 인터페이스