IMDSPDevice2::GetCanonicalName 메서드(mswmdm.h)

GetCanonicalPName 메서드는 디바이스의 정식 이름을 가져옵니다.

구문

HRESULT GetCanonicalName(
  [out] LPWSTR pwszPnPName,
  [in]  UINT   nMaxChars
);

[out] pwszPnPName

정식 이름을 포함하는 null로 끝나는 와이드 문자 버퍼입니다. 호출자가 이 버퍼를 할당하고 해제합니다.

[in] nMaxChars

종료 문자를 포함하여 pwszCanonicalName에 배치할 수 있는 최대 문자 수를 포함하는 정수입니다.

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

이 메서드는 디바이스의 정식 이름을 반환합니다. 서비스 공급자는 디바이스의 디바이스 경로 이름을 정식 이름으로 반환해야 합니다. 서비스 공급자는 IMDServiceProvider2 인터페이스의 CreateDevice 메서드에 디바이스 경로 이름을 전달합니다.