IMDSPDevice2::GetCanonicalName メソッド (mswmdm.h)

GetCanonicalPName メソッドは、デバイスの正規名を取得します。

構文

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

[out] pwszPnPName

標準名を保持するワイド文字の null で終わるバッファー。呼び出し元は、このバッファーを割り当てて解放します。

[in] nMaxChars

pwszCanonicalName に配置できる最大文字数 (終了文字を含む) を含む整数。

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

このメソッドは、デバイスの正規名を返します。サービスプロバイダーは、デバイスのデバイスパス名を正規名として返す必要があります。サービスプロバイダーには、IMDServiceProvider2 インターフェイスの CreateDevice メソッドでデバイスパス名が渡されます。

これは省略可能です。詳細については、「必須インターフェイスと省略可能なインターフェイス」を参照してください。