SignerTimeStampEx2 関数

SignerTimeStampEx2 関数は、指定されたサブジェクトにタイム スタンプを設定し、必要に応じて BLOB へのポインターを含むSIGNER_CONTEXT構造体へのポインターを返します。 この関数を使用して、X.509 公開キー 基盤、RFC 3161 準拠のタイム スタンプを実行できます。

Note

この関数には、ヘッダー ファイルまたはインポート ライブラリが関連付けされません。 この関数を呼び出すには、ユーザー定義ヘッダー ファイルを作成し、 LoadLibrary 関数と GetProcAddress 関数を使用して、Mssign32.dllに動的にリンクする必要があります。

 

構文

HRESULT WINAPI SignerTimeStampEx2(
  _Reserved_ DWORD               dwFlags,
  _In_       SIGNER_SUBJECT_INFO *pSubjectInfo,
  _In_       LPCWSTR             pwszHttpTimeStamp,
  _In_       ALG_ID              dwAlgId,
  _In_       PCRYPT_ATTRIBUTES   psRequest,
  _In_       LPVOID              pSipData,
  _Out_      SIGNER_CONTEXT      **ppSignerContext 
);

パラメーター

dwFlags [in]

生成するタイム スタンプの種類を指定する 値。 このパラメーターには、次の値のいずれかを指定できます。 値は相互に排他的です。

値	説明
SIGNER_TIMESTAMP_AUTHENTICODE	Authenticode タイム スタンプを指定します。
SIGNER_TIMESTAMP_RFC3161	RFC 3161 準拠のタイム スタンプを指定します。

 

pSubjectInfo [in]

タイムスタンプが設定される対象を表す SIGNER_SUBJECT_INFO 構造体のアドレス。

pwszHttpTimeStamp [in]

タイム スタンプ サーバーの URL を含む null で終わる Unicode 文字列のアドレス。

dwAlgId [in]

RFC 3161 準拠のタイム スタンプの実行に使用するハッシュ アルゴリズムを指定します。 Authenticode タイム スタンプの場合、このパラメーターは無視されます。

psRequest [in]

省略可能。 タイム スタンプ要求に追加される属性を含む CRYPT_ATTRIBUTES 構造体のアドレス。

このパラメーターは省略可能であり、含まれていない場合は NULL にすることができます。

pSipData [in]

省略可能。 サブジェクト インターフェイス パッケージ (SIP) 関数に追加データとして渡される 32 ビット値。 このパラメーターの形式と内容は、SIP プロバイダーによって定義されます。

このパラメーターは省略可能であり、含まれていない場合は NULL にすることができます。

ppSignerContext [out]

省略可能。 署名付き BLOB を含む SIGNER_CONTEXT 構造体へのポインターのアドレス。 SIGNER_CONTEXT構造体の使用が完了したら、SignerFreeSignerContext 関数を呼び出して解放します。

戻り値

関数が成功した場合、関数はS_OKを返します。

関数が失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

必要条件

要件	値
サポートされている最小のクライアント	Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2 [デスクトップ アプリのみ]
[DLL]	Mssign32.dll

関連項目

SignerTimeStamp

SignerTimeStampEx