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」を参照してください。
要件
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | サポートなし |
対象プラットフォーム | Windows |
ヘッダー | upnp.h |
[DLL] | Upnp.dll |