SignerTimeStampEx 関数

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

Note

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

 

構文

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

パラメーター

dwFlags [in]

予約済み。 このパラメーターは 0 に設定する必要があります。

pSubjectInfo [in]

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

pwszHttpTimeStamp [in]

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

psRequest [in]

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

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

pSipData [in]

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

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

ppSignerContext [out]

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

戻り値

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

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

要件

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

関連項目

SignerTimeStamp