iOSAndroidWindows
|
説明 |
UUIDを取得します。
UUID（ユニバーサルユニークID）は世界中で重複しないことを目的に設計された汎用的な一意識別子で、128bitのランダムな数値を文字列で表現したものです。例えば次のような文字列となります。
"DE07FFE8-A2FF-47CD-BA46-A993160F9A92"
一意性を確保するために、UUIDの作成では、作成した時間や作成したコンピュータのMACアドレスなどの情報を参照することがあります。UUIDが重複する可能性は極めて低い確率ですが、完全に重複しないことを保障するものではありません。
Windows環境ではOLEオブジェクト、ActiveXオブジェクトの識別子や製品固有の識別子として利用されています。GUID（グローバルユニークID）と呼ばれることもあります。
GetUUIDメソッドの呼び出しで返されるUUIDは、keyとペアでユーザごと（Windows98、Meのユーザ共通設定時を除く）に記憶され、すでにkeyに対応するUUIDが生成されている場合はそのUUIDを返します。keyに対応するUUIDが生成されていない場合には、新しく生成したUUIDを記録して返します。
記録されたUUIDは、Biz/Browserを再起動したり、コンピュータを再起動しても有効ですが、コンピュータのトラブルなどで失われる可能性があります。一度失われたUUIDを復元する手段はありませんので、回復が不可能なデータをUUIDの記録に依存して処理しないことをお勧めします。
keyとUUIDのペアは、オプションのパラメータpass-phraseを指定しない場合は、すべてのアプリケーションで共有される名前空間に記録されます。pass-phraseを指定した場合には、GetUUIDメソッドを実行したCRSをダウンロードしたサーバ固有の名前空間に記録されます。つまり、Server-AからダウンロードしたCRSとServer-BからダウンロードしたCRSで同じキーを指定してGetUUIDメソッドを呼び出した場合、pass-phraseを指定しないときには同じUUIDが返され、pass-phraseを指定すると、それぞれは別のキーとして扱われ、別のUUIDが返されます。
オプションのパラメータpass-phraseを指定しない場合は、UUIDはクリアテキストで記録されますが、pass-phraseを指定すると暗号化されて記録されます。一度pass-phraseを指定して記録されたUUIDは、同じpass-phraseを指定してGetUUIDメソッドを呼び出さなければ取得できず、異なるpass-phraseやpass-phraseを省略した場合RTM-27の例外が発生します。
|
|
|
呼出形式 |
var result = rt.GetUUID( key [, pass-phrase ] )
|
|
|
戻り値 |
UUIDの文字列
|
|
|
引数 |
String key |
UUIDに対応する識別子 16文字までの英数字が指定できます。 |
|
|
String pass-phrase |
UUIDを暗号化して記録する場合のパスフレーズ
|
|
例外 |
RTM-26 |
識別子が不正です |
|
|
RTM-18 |
レジストリアクセスエラー |
|
|
RTM-27 |
UUIDが生成できません
|
|
使用例 |
var rt = new Runtime;
var uuid = rt.GetUUID("appkey", "pass");
|
|
|
関連項目 |
DeleteUUIDメソッド |
|