{{div_begin}}
[[←　15 章に戻る|Palm OS Programmer's API Reference/15]]　[[↑トップへ|Palm OS Programmer's API Reference]]　[[17 章に進む　→|Palm OS Programmer's API Reference/17]]
{{div_end}}

{{div_begin style="margin-bottom:-10px"}}
!!!16 プライベート レコード
{{div_end}}

{{div_begin "style='position:absolute;right:0px;font-size:70%;margin-right:15px;margin-top:15px;width:250px;'"}}
*{{goto Private Reocrd Data Structures,プライベート レコード データ構造体}}
**{{goto privateRecordViewEnum,privateRecordViewEnum}}
*{{goto Private Record Functions,プライベート レコード関数}}
**{{goto SecSelectViewStatus,SecSelectViewStatus}}
**{{goto SecVerifyPW,SecVerifyPW}}
{{div_end}}

{{div_begin "style='position:relative;padding:0px;padding-right:5px;padding-left:10px;margin-right:250px;margin-top:20px;width:auto;border-right:dotted;border-right-width:2px;border-right-color:silver;'"}}
この章では、ヘッダ ファイル {{span style='color:blue;font-family:monospace;',PrivateRecords.h}} で定義されている、プライベート レコード API について説明します。以下のことについて説明します。

*{{goto Private Record Data Structures,プライベート レコード データ構造体}}
*{{goto Private Record Functions,プライベート レコード関数}}


!!{{anchor Private Record Data Structures}}プライベート レコード データ構造体 {{goto top,^TOP^}}


!{{anchor privateRecordViewEnum}}privateRecordViewEnum 列挙体 {{goto top,^TOP^}}

'''目的'''

{{span style='color:blue;font-family:monospace;',privateRecordViewEnum}} 列挙型はプライベート レコードを表示するための使用可能な選択肢を提供します。

'''Prototype'''

 typedef enum privateRecordViewEnum {
 	showPrivateRecords = 0x00,
 	maskPrivateRecords,
 	hidePrivateRecords
 } privateRecordViewEnum;

'''定数'''

*{{span style='color:blue;font-family:monospace;',showPrivateRecords}}
**プライベート レコードをユーザ インターフェイスの中に表示します。
*{{span style='color:blue;font-family:monospace;',maskPrivateRecords}}
**プライベート レコードが表示される場所に影を付けます。（訳者注: プライベート レコードを表示するが、黒っぽくするということ。）
*{{span style='color:blue;font-family:monospace;',hidePrivateRecords}}
**プライベート レコードを隠し、その存在をユーザ インターフェイスに示しません。


!!{{anchor Private Record Functions}}プライベート レコード関数 {{goto top,^TOP^}}


!{{anchor SecSelectViewStatus}}SecSelectViewStatus  関数 {{goto top,^TOP^}}

'''目的'''

ユーザがプライベート レコードを隠すか、表示するか、マスクをかけるか選択することができるフォームを表示します。

'''宣言されている場所'''

{{span style='color:blue;font-family:monospace;',PrivateRecords.h}}

'''Prototype'''

 privateRecordViewEnum SecSelectViewStatus (
 	void
 )

'''パラメータ'''

ありません。

'''返り値'''

ユーザが選択したオプションがどれなのかを示す定数を返します。{{goto privateRecordViewEnum,privateRecordViewEnum}} を参照してください。

'''コメント'''

この関数は、ユーザが設定 {{span style='color:blue;font-family:monospace;',prefShowPrivateRecords}} を変更することを可能にするダイアログを表示します。{{span style='color:blue;font-family:monospace;',prefShowPrivateRecords}} はプライベート レコードがどのように表示されるかを制御します。

ユーザがこのダイアログの中で OK ボタンをタップしたとき、ユーザが設定を変更したかどうかを調べるために {{goto SecVerifyPW,SecVerifyPW()}} が呼び出されます。変更されている場合、{{goto SecVerifyPW,SecVerifyPW()}} はユーザが適切なパスワードを入力するためのプロンプトを表示します。

この関数の呼出し後、コードは返り値または {{span style='color:blue;font-family:monospace;',prefShowPrivateRecords}} の値をチェックし、適切にプライベート レコードをマスク、表示、または隠すべきです。部分的な例を示している {{goto TblSetRowMasked,TblSetRowMasked()|Palm OS Programmer's API Reference/20}} を参照してください。

'''互換性'''

{{goto 3.5 New Feature Set,3.5 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。


!{{anchor SecVerifyPW}}SecVerifyPW 関数 {{goto top,^TOP^}}

'''目的'''

パスワード ダイアログを表示し、パスワードを評価し、プライベート レコード設定を変更します。

'''宣言されている場所'''

{{span style='color:blue;font-family:monospace;',PrivateRecords.h}}

'''Prototype'''

 Boolean SecVerifyPW(
 	privateRecordViewEnum newSecLevel
 )

'''パラメータ'''

*{{span style='color:blue;font-family:monospace;',→ newSecLevel}}
**プライベート レコード ダイアログで選択されたセキュリティ レベル（表示、隠す、マスク）。

'''返り値'''

{{span style='color:blue;font-family:monospace;',prefShowPrivateRecords}} が成功裏に変更された場合、{{span style='color:blue;font-family:monospace;',true}} を返します。そうでない場合、{{span style='color:blue;font-family:monospace;',false}} を返します。

'''コメント'''

この関数は {{span style='color:blue;font-family:monospace;',newSecLevel}} と現在のプライベート レコード設定の値を比較します。2 つの値が異なり、{{span style='color:blue;font-family:monospace;',newSecLevel}} がセキュリティ レベルを下げることを示す場合、ユーザにパスワード入力を促すダイアログが表示されます。（「隠す」が一番セキュリティ レベルが高く、続いて「マスク」。プライベート レコードを表示する場合が最もセキュリティ レベルが低いと見なされます。）パスワード入力が成功した場合、設定は変更されます。

この関数はまた、セキュリティ レベルが「隠す」または「マスク」のどちらかに変更された場合、アラート メッセージを表示します。

'''互換性'''

{{goto 3.5 New Feature Set,3.5 New Feature Set|Palm OS Programmer's API Reference/B-1}} が存在する場合にのみ、実装されます。
{{div_end}}

{{div_begin "style='border-top:solid;border-top-width:1px;border-top-color:silver;'"}}
[[←　15 章に戻る|Palm OS Programmer's API Reference/15]]　[[↑トップへ|Palm OS Programmer's API Reference]]　[[17 章に進む　→|Palm OS Programmer's API Reference/17]]
{{div_end}}