IPart::GetGlobalId メソッド (devicetopology.h)
GetGlobalId メソッドは、この部分のグローバル ID を取得します。
構文
HRESULT GetGlobalId(
[out] LPWSTR *ppwstrGlobalId
);
パラメーター
[out] ppwstrGlobalId
グローバル ID を含む null で終わるワイド文字列のアドレスをメソッドが書き込むポインター変数へのポインター。 メソッドは、文字列のストレージを割り当てます。 呼び出し元は、不要になったときに CoTaskMemFree 関数を呼び出すことによって、ストレージを解放する役割を担います。 GetGlobalId 呼び出しが失敗した場合、*ppwstrGlobalId は NULL です。 CoTaskMemFree の詳細については、Windows SDK のドキュメントを参照してください。
戻り値
メソッドが成功した場合は、S_OK を返します。 失敗した場合、次の表に示す値が含まれますが、これに限定されません。
リターン コード | 説明 |
---|---|
|
ポインター ppwstrGlobalId は NULL です。 |
|
メモリが不足しています。 |
注釈
グローバル ID は、システム内のすべてのデバイス トポロジ内のすべての部分の一部を一意に識別する文字列です。 クライアントは、この文字列を不透明として扱う必要があります。 つまり、クライアントは文字列の内容を解析して部分に関する情報を取得 しようとしないでください 。 その理由は、文字列形式が未定義であり、DeviceTopology API の実装から次の実装に変更される可能性があるためです。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | devicetopology.h |