Microsoft DirectX 8.0 |
MSDVDAdm "管理" オブジェクトのメソッドおよびプロパティを使用すると、スクリプト アプリケーションから、Microsoft® Windows® レジストリ内にあるアプリケーション自体のデフォルト設定を修正できる。レジストリは、すべての Windows システムにあるデータベースであり、アプリケーションからアプリケーション自体に関する情報を格納して、初期化または実行時に使用することができる。
これらのメソッドおよびプロパティの多くは、MSWebDVD オブジェクト自体の現在値を設定または取得するものではない。つまり、たとえば GetParentalLevel を呼び出したときに返される値は、オブジェクトに格納された現在のペアレンタル ロック レベルではない。返される値は、レジストリに格納されたデフォルトのペアレンタル ロック レベルである。現在のペアレンタル ロック レベルを取得するには、MSWebDVD メソッドの GetPlayerParentalLevel を呼び出す。SaveParentalLevel を呼び出すと、ただ、新しいデフォルトのペアレンタル ロック レベルがレジストリに書き込まれる。その変更を直ちに MSWebDVD オブジェクトに反映するには、MSWebDVD メソッドの SelectParentalLevel を呼び出す必要がある。デフォルトのロケール識別子 (LCID) 関連メソッドも同様の動作をする。
一方、BookmarkOnStop メソッドおよび BookmarkOnClose メソッドでの設定は直ちに反映される。これは、MSWebDVD オブジェクトが、初期化時ではなく、ユーザーが再生を停止するかアプリケーションを終了する直前に、これらの設定を確認するためである。
MSDVDAdm オブジェクトには、MSWebDVD の DVDAdm プロパティを通じてアクセスする。このため、たとえば MSWebDVD オブジェクトの名前が "DVD" であれば、次のように ChangePassword を呼び出す。
DVD.DVDAdm.ChangePassword(sUserName, sOld, sNew);
メソッドおよびプロパティ
次の一覧は、MSDVDAdm オブジェクトで公開されるメソッドおよびプロパティである。
メソッド ChangePassword アプリケーションの新しいパスワードをレジストリに保存する。 SaveParentalLevel 新しいデフォルトのペアレンタル ロック レベルをレジストリに保存する。 SaveParentalCountry アプリケーションの新しいペアレンタル カントリをレジストリに保存する。 ConfirmPassword 指定されたパスワードが直前に保存したパスワードと一致するかどうか検査する。 GetParentalLevel レジストリに最後に保存したペアレンタル ロック レベルを取得する。 GetParentalCountry レジストリに最後に保存したペアレンタル カントリを取得する。 RestoreScreenSaver システムのスクリーン セーバー設定を復元する。 プロパティ DisableScreenSaver システムのスクリーン セーバーのオン/オフを切り替える。 DefaultAudioLCID オーディオ ストリームに対応するユーザーが指定したデフォルト LCID のレジストリ設定を設定または取得する。 DefaultSubpictureLCID サブピクチャ ストリームに対応するユーザーが指定したデフォルト LCID のレジストリ設定を設定または取得する。 DefaultMenuLCID メニューに対応するユーザーが指定したデフォルト LCID のレジストリ設定を設定または取得する。 BookmarkOnStop MSDVDAdm オブジェクトに、ユーザーが [停止] ボタンをクリックしたときに現在位置と設定のブックマークを自動的に保存するかどうかを知らせる値を、設定または取得する。 BookmarkOnClose MSDVDAdm オブジェクトに、ユーザーがアプリケーションを終了したときに現在位置と設定のブックマークを自動的に保存するかどうかを知らせる値を、設定または取得する。
MSDVDAdm オブジェクトに、ユーザーがアプリケーションを終了したときに現在位置と設定のブックマークを自動的に保存するかどうかを知らせる値を、設定または取得する。
構文
[ bBookmarkOnClose = ] DVD.DVDAdm.BookmarkOnClose
構成要素
DVD MSWebDVD オブジェクトを表すオブジェクト式。 DVDAdm MSWebDVD オブジェクトの DVDAdm プロパティ。 bBookmarkOnClose ユーザーが DVD プレーヤー アプリケーションを終了したときに、ディスク上の位置、ペアレンタル ロック レベル、およびペアレンタル カントリを含むすべての DVD 設定のブックマークを、MSDVDAdm コントロールで保存するかどうかを示すブール型の値。
注意
このプロパティは、デフォルト値が TRUE の読み書き可能なプロパティである。
参照
MSWebDVD オブジェクトに、ユーザーが [停止] ボタンをクリックしたときに現在位置と設定のブックマークを自動的に保存するかどうかを知らせる値を、設定または取得する。
構文
[ bBookmarkOnStop = ] DVD.DVDAdm.BookmarkOnStop
構成要素
DVD MSWebDVD オブジェクトを表すオブジェクト式。 DVDAdm MSWebDVD オブジェクトの DVDAdm プロパティ。 bBookmarkOnStop ディスク上の位置、ペアレンタル ロック レベル、およびペアレンタル カントリを含むすべての DVD 設定のブックマークを、MSDVDAdm オブジェクトで保存するかどうかを示すブール型の値。
注意
このプロパティは、デフォルト値が FALSE の読み書き可能なプロパティである。
ブックマークはそのコンピュータでのみ有効である。別のコンピュータで読み取るため、ユーザーがブックマークを保存し、ほかのユーザーに送ることはできない。
参照
アプリケーションの新しいパスワードをレジストリに保存する。
構文
DVD.DVDAdm.ChangePassword(sUserName, sOld, sNew );
構成要素
DVD MSWebDVD オブジェクトを表すオブジェクト式。 DVDAdm MSWebDVD オブジェクトの DVDAdm プロパティ。 sUserName 現在のユーザーのログオン名を指定する文字列型の値。MSDVDAdm オブジェクトはこのパラメータを無視する。「注意」を参照すること。 sOld ユーザーの古いパスワードを指定する文字列型の値。 sNew ユーザーの新しいパスワードを指定する文字列型の値。NULL であってはならない。
戻り値
戻り値なし。
注意
現在、sUserName パラメータは、このメソッドを含むすべての関連メソッドで無視される。これは、パスワードを知っているユーザーであれば、誰でもペアレンタル ロック レベルを設定できることを意味する。アプリケーションには、パスワードとペアレンタル ロック レベルがそれぞれ 1 つしかない。個々のユーザーのログオン名または複数パスワードの管理はサポートされていない。ペアレンタル ロックを使用するには、大人がパスワードを設定したうえで、子供に適したペアレンタル ロック レベルを設定する必要がある。成人向けコンテンツが格納されたディスクを大人が再生するには、ペアレンタル ロック レベルを変更し、見終わってから元に戻せばよい。パスワードを知らない限り、子供は設定したペアレンタル ロック レベル以下のコンテンツしか見ることができない。
参照
指定されたパスワードが直前に保存したパスワードと一致するかどうか検査する。
構文
[ bIsConfirmed = ] DVD.DVDAdm.ConfirmPassword(sUserName, sPassword);
構成要素
DVD MSWebDVD オブジェクトを表すオブジェクト式。 DVDAdm MSWebDVD オブジェクトの DVDAdm プロパティ。 sUserName ユーザー名を指定する文字列型の値。「注意」を参照すること。 sPassword 新しいパスワードを指定する文字列型の値。
戻り値
指定されたパスワードが既存のパスワードと一致する場合は、TRUE を返す。それ以外の場合は、FALSE を返す。
注意
現在、sUserName パラメータは、このメソッドを含むすべての関連メソッドで無視される。
参照
オーディオ ストリームに対応するユーザーが指定したデフォルト LCID のレジストリ設定を設定または取得する。
構文
[ iAudioLCID = ] DVD.DVDAdm.DefaultAudioLCID
構成要素
DVD MSWebDVD オブジェクトを表すオブジェクト式。 DVDAdm MSWebDVD オブジェクトの DVDAdm プロパティ。 iAudioLCID DVD アプリケーションに対応するレジストリ設定に格納された、ユーザーが指定したデフォルトのオーディオ LCID を表す整数型の値。この値は、DVD に明記されたデフォルトのオーディオ ストリームと等しいとは限らない。有効な LCID の範囲については、Platform SDK の Microsoft® Win32® ドキュメントを参照すること。 このプロパティは、デフォルト値を持たない読み書き可能なプロパティである。デフォルトのオーディオ LCID を指定しなかった場合、MSDVDAdm オブジェクトは、デフォルト ストリームとしてディスクにマークされたオーディオ ストリームを再生する。
メニューに対応するユーザーが指定したデフォルト LCID のレジストリ設定を設定または取得する。
構文
[ iMenuLCID = ] DVD.DVDAdm.DefaultMenuLCID
構成要素
DVD MSWebDVD オブジェクトを表すオブジェクト式。 DVDAdm MSWebDVD オブジェクトの DVDAdm プロパティ。 iMenuLCID DVD アプリケーションに対応するレジストリ設定に格納された LCID を表す整数型の値。この値は、DVD に明記されたデフォルトのメニュー言語と等しいとは限らない。有効な LCID の範囲については、Platform SDK の Win32 ドキュメントを参照すること。 このプロパティは、デフォルト値を持たない読み書き可能なプロパティである。デフォルトのメニュー LCID を指定しなかった場合、MSDVDAdm オブジェクトは、デフォルトのメニュー言語としてディスクにマークされた言語を使用する。
サブピクチャ ストリームに対応するユーザーが指定したデフォルト LCID のレジストリ設定を設定または取得する。
構文
[ iSubpictureLCID = ] DVD.DVDAdm.DefaultSubpictureLCID
構成要素
DVD MSWebDVD オブジェクトを表すオブジェクト式。 DVDAdm MSWebDVD オブジェクトの DVDAdm プロパティ。 iSubpictureLCID DVD アプリケーションに対応するレジストリ設定に格納された、ユーザーが指定したデフォルトのサブピクチャ LCID を表す整数型の値。この値は、DVD に明記されたデフォルトのサブピクチャ ストリームと等しいとは限らない。有効な LCID の範囲については、Platform SDK の Win32 ドキュメントを参照すること。 このプロパティは、デフォルト値を持たない読み書き可能なプロパティである。デフォルトのサブピクチャ LCID を指定しなかった場合、MSDVDAdm オブジェクトは、デフォルト ストリームとしてディスクにマークされたサブピクチャ ストリームを再生する。
システムのスクリーン セーバーのオン/オフを切り替える。
構文
[ bDisabled = ] DVD.DVDAdm.DisableScreenSaver
構成要素
DVD MSWebDVD オブジェクトを表すオブジェクト式。 DVDAdm MSWebDVD オブジェクトの DVDAdm プロパティ。 bDisabled システムの DVD プレーヤー アプリケーションに対応するスクリーン セーバー設定がオフになっているかどうかを示すブール型の値。TRUE はオフになっていることを意味する。 このプロパティは、デフォルト値が TRUE の読み書き可能なプロパティである。
注意
DVD ビデオのディスクを見るときには、マウスやキーボードを長時間使用しないことが多い。このため、MSWebDVD ActiveX® コントロールは、デフォルトでシステムのスクリーン セーバーを無効にする。
参照
レジストリに最後に保存したペアレンタル カントリを取得する。
構文
[ iParentalCountry = ] DVD.DVDAdm.GetParentalCountry();
構成要素
DVD MSWebDVD オブジェクトを表すオブジェクト式。 DVDAdm MSWebDVD オブジェクトの DVDAdm プロパティ。
戻り値
レジストリに格納されたデフォルトの国別コードを示す整数を返す。
注意
このメソッドで取得するペアレンタル カントリは、MSWebDVD オブジェクトに現在格納されている国と同じとは限らない。
レジストリに最後に保存したペアレンタル ロック レベルを取得する。
構文
[ iParentalLevel = ] DVD.DVDAdm.GetParentalLevel();
構成要素
DVD MSWebDVD オブジェクトを表すオブジェクト式。 DVDAdm MSWebDVD オブジェクトの DVDAdm プロパティ。
戻り値
デフォルトのペアレンタル ロック レベルを示す 1 〜 8 の整数を返す。
注意
このメソッドで取得するペアレンタル ロック レベルは、MSWebDVD コントロールに現在格納されているペアレンタル ロック レベルと等しいとは限らない。コントロールに現在格納されているペアレンタル ロック レベルを取得するには、MSWebDVD.GetPlayerParentalLevel を呼び出す。-1 の値はペアレンタル ロックが無効であることを示す。
システムのスクリーン セーバー設定を復元する。
構文
DVD.DVDAdm.RestoreScreenSaver();
構成要素
DVD MSWebDVD オブジェクトを表すオブジェクト式。 DVDAdm MSWebDVD オブジェクトの DVDAdm プロパティ。
戻り値
戻り値なし。
注意
通常、DVD アプリケーションでは、起動時に DisableScreenSaver プロパティを TRUE に設定してシステムのスクリーン セーバーを無効にし、終了時に RestoreScreenSaver を呼び出してスクリーン セーバーをもう一度有効にする。アプリケーションでシステムのスクリーン セーバー設定を使用しないなら、このメソッドを呼び出したり、DisableScreenSaver プロパティをセットしたりする必要はない。
アプリケーションの新しいペアレンタル カントリをレジストリに保存する。
構文
DVD.DVDAdm.SaveParentalCountry( iCountry, sUserName, sPassword);
構成要素
DVD MSWebDVD オブジェクトを表すオブジェクト式。 DVDAdm MSWebDVD オブジェクトの DVDAdm プロパティ。 iCountry ペアレンタル カントリを指定する整数型の値。 sUserName ユーザー名を指定する文字列型の値。現在は無視される。 sPassword パスワードを指定する文字列型の値。
戻り値
戻り値なし。
注意
このメソッドを使用すると、現在のパスワードを知っているユーザーが、レジストリに新しいペアレンタル カントリの設定を保存できる。MSDVDAdm の全メソッドと同じように、このメソッドは、プレーヤー内の現在のペアレンタル ロック レベルは変更せずに、レジストリのみを変更する。このため、新しい国で開くのは、次に作成した MSWebDVD オブジェクトである。プレーヤー内のペアレンタル カントリを変更するには、MSWebDVD.SelectParentalCountry を呼び出す。この場合、レジストリ設定は変更されない。
参照
新しいデフォルトのペアレンタル ロック レベルをレジストリに保存する。
構文
DVD.DVDAdm.SaveParentalLevel( iLevel, sUserName, sPassword);
構成要素
DVD MSWebDVD オブジェクトを表すオブジェクト式。 DVDAdm MSWebDVD オブジェクトの DVDAdm プロパティ。 iLevel ペアレンタル ロック レベルを指定する整数型の値 (1 〜 8)。 sUserName ユーザー名を指定する文字列型の値。現在は無視される。 sPassword パスワードを指定する文字列型の値。
戻り値
戻り値なし。
注意
このメソッドを使用すると、現在のパスワードを知っているユーザーが、レジストリに新しいペアレンタル ロック レベル設定を保存できる。MSDVDAdm の全メソッドと同じように、このメソッドは、プレーヤー内の現在のペアレンタル ロック レベルは変更せずに、レジストリのみを変更する。このため、新しいペアレンタル ロック レベルで開くのは、次に起動した MSWebDVD オブジェクトである。プレーヤー内のペアレンタル ロック レベルを変更するには、MSWebDVD.SelectParentallevel を呼び出す。この場合、レジストリ設定は変更されない。 -1 の値はペアレンタル ロックが無効であることを示す。