IMsnNotification::put_ID プロパティ
ID プロパティの値を設定します。ID は、通知 ID を指定する、Unicode 文字列で表された整数のプロパティです。このプロパティは必須です。
構文
HRESULT put_ID(
BSTR newVal
);
パラメータ
- newVal
[入力] Unicode 文字列。この通知の ID が含まれます。newVal を NULL に設定してこのメソッドを呼び出すと、ID プロパティがクリアされます。
戻り値
S_OK | 呼び出しが正常に行われたか、newVal が NULL です。 |
E_OUTOFMEMORY | プロパティに必要なメモリを割り当てようとしているときにエラーが発生しました。 |
解説
ID は、追跡の目的で通知の送信者が割り当てます。この値は、新しい通知を一意に識別するか、この通知と置き換えられる、以前に送信された通知の ID と一致します。 ID が以前の通知の ID と一致する場合は、最近受信した通知の一覧で以前の通知がこの通知に置き換えられます。最近受信した通知の一覧は、Microsoft® Windows® Messenger または MSN® Messenger の [Alerts] タブおよび .NET Alerts Web サイトの [通知の履歴] に表示されます。
MSN Messenger および Microsoft Windows Messenger のクライアントは、この値を notification_id というパラメータとしてアクション用 URL とサブスクリプション用 URL に追加します。
このプロパティの有効な範囲は、0 ~ 4,294,967,295 (32 bit) です。
関連項目
C++ リファレンスの概要 | IMsnNotification::get_ID プロパティ
|