IXpsSignatureRequest::GetSpotLocation メソッド (xpsdigitalsignature.h)

ページと、表示されているデジタル署名またはデジタル署名要求が表示されるページ上の場所を取得します。

構文

HRESULT GetSpotLocation(
  [out] INT32       *pageIndex,
  [out] IOpcPartUri **pagePartName,
  [out] float       *x,
  [out] float       *y
);

[out] pageIndex

署名またはデジタル署名要求を含む FixedPage パーツのインデックス値。署名要求にスポット位置が指定されていない場合は、–1 が返されます。

[out] pagePartName

デジタル署名を表示する FixedPage を含むパーツの IOpcPartUri インターフェイスへのポインター。

[out] x

ページ上の署名スポットの x 座標値。

[out] y

ページ上の署名スポットの y 座標値。

このメソッドは HRESULT を返します。使用可能な値には、次の表に示す値が含まれますが、これらに限定されません。この表に記載されていない戻り値については、「 XPS デジタル署名 API エラーと XPS ドキュメントエラー」を参照してください。

リターンコード	説明
S_OK	メソッドが成功しました。
E_POINTER	pageIndex、 pagePartName、 x、または y は NULL です。
E_UNEXPECTED	インターフェイスが署名マネージャーに接続されていません。

署名スポットの場所は、ページの左上隅から XPS 単位で指定されます。 1 インチあたり 96 個の XPS ユニットがあります。

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	xpsdigitalsignature.h