IUPnPDevice::get_SerialNumber メソッド (upnp.h)

SerialNumber プロパティは、デバイスのシリアル番号の人間が判読できる形式を指定します。

構文

HRESULT get_SerialNumber(
  [out] BSTR *pbstr
);

[out] pbstr

シリアル番号を含む文字列への参照を受け取ります。この文字列が使用されなくなったら、 SysFreeString で解放します。このプロパティは省略可能であり、デバイスにシリアル番号がない可能性があります。

C++ の場合: このプロパティの "get" メソッドが成功した場合、戻り値はS_OK。デバイスがシリアル番号を指定しなかった場合、戻り値はS_FALSE。それ以外の場合、メソッドは WinError.h で定義されている COM エラーコードのいずれかを返します。

このプロパティは省略可能であり、 pbstr は NULL である可能性があります。

複数のデバイスで同じシリアル番号を使用できます。 2 つのデバイスオブジェクトが同じデバイスを記述しているかどうかを確認するには、一意のデバイス名を使用します。詳細については、「 UniqueDeviceName」を参照してください。