次の方法で共有

IMsnNotification::put_SiteURL プロパティ

  • [アーティクル]

IMsnNotification

SiteURL プロパティの値を設定します。SiteURL は、Microsoft® .NET Alerts プロバイダの Web サイトへの基本 URL を指定する Unicode 文字列のプロパティです。ActionURL、SubscribeURL、および BodyIcon の各プロパティで指定した値は、この URL を基準にしている必要があります。このプロパティは必須です。

構文

HRESULT put_SiteURL(
    BSTR newVal
);

パラメータ

  • newVal
    [入力] Unicode 文字列。サイト URL が含まれます。newVal を NULL に設定してこのメソッドを呼び出すと、SiteURL プロパティがクリアされます。

戻り値

S_OK 呼び出しが正常に行われたか、newVal が NULL です。
E_OUTOFMEMORY プロパティに必要なメモリを割り当てようとしているときにエラーが発生しました。

解説

このプロパティに指定できる最大許容バイト数は 256 バイトです。このプロパティの長さの制限は、.NET Alerts クライアント ライブラリではなく、.NET Alerts ルーティング エンジンによって強制されます。長さの制限を超えてもクライアント ライブラリは警告やエラーを出しませんが、ルーティング エンジンによって通知が拒否されます。

.NET Alerts ルーティング エンジンによって通知が処理されると、ActionURL、BodyIcon、および SubscribeURL の各プロパティで指定した相対 URL が、SiteURL で指定した基本サイト URL に追加されます。サイト URL と相対 URL は、結合されて正しい形式の URL になるように指定する必要があります。サイト URL の末尾にスラッシュ ("/") を付けるか、相対 URL の先頭にスラッシュを付けますが、両方付ける必要はありません。

このプロパティは、XML でエンコードされている必要があります。XML エンコードの問題は、通知が米国 MSN® Mobile に登録されたデバイスに配信されない一般的な原因の 1 つです。次の表に、エンコードが必要な文字を示します。

文字 エンコード
< &lt;
> &gt;
& &amp;
" &quot;
' &apos;

関連項目

C++ リファレンスの概要  |  IMsnNotification::get_SiteURL プロパティ

  |