SignerSignEx 関数

  • [アーティクル]

SignerSignEx 関数は、指定したファイルに署名し、署名されたデータへのポインターを返します。

Note

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

 

構文

HRESULT WINAPI SignerSignEx(
  _In_     DWORD                 dwFlags,
  _In_     SIGNER_SUBJECT_INFO   *pSubjectInfo,
  _In_     SIGNER_CERT           *pSignerCert,
  _In_     SIGNER_SIGNATURE_INFO *pSignatureInfo,
  _In_opt_ SIGNER_PROVIDER_INFO  *pProviderInfo,
  _In_opt_ LPCWSTR               pwszHttpTimeStamp,
  _In_opt_ PCRYPT_ATTRIBUTES     psRequest,
  _In_opt_ LPVOID                pSipData,
  _Out_    SIGNER_CONTEXT        **ppSignerContext
);

パラメーター

dwFlags [in]

この関数の動作を変更します。

署名するファイルが移植可能な実行可能ファイル (PE) ファイルの場合、0 または次の値の 1 つ以上の組み合わせにすることができます。 これらの識別子は Mssip.h で定義されています。

値 説明
SPC_EXC_PE_PAGE_HASHES_FLAG
0x10
 PE ファイルの SIP 間接データを作成するときに、ページ ハッシュを除外します。 このフラグは 、SPC_INC_PE_PAGE_HASHES_FLAG フラグよりも優先されます。
SPC_EXC_PE_PAGE_HASHES_FLAGまたはSPC_INC_PE_PAGE_HASHES_FLAG フラグが指定されていない場合は、WintrustSetDefaultIncludePEPageHashes 関数で設定された値がこの設定に使用されます。 この設定の既定値は、PE ファイルの SIP 間接データを作成するときにページ ハッシュを除外することです。
Windows Server 2003 および Windows XP: この値はサポートされていません。
SPC_INC_PE_IMPORT_ADDR_TABLE_FLAG
0x20
 この値はサポートされていません。
SPC_INC_PE_DEBUG_INFO_FLAG
0x40
 この値はサポートされていません。
SPC_INC_PE_RESOURCES_FLAG
0x80
 この値はサポートされていません。
SPC_INC_PE_PAGE_HASHES_FLAG
0x100
 PE ファイルの SIP 間接データを作成するときにページ ハッシュを含めます。
Windows Server 2003 および Windows XP: この値はサポートされていません。

 

pSubjectInfo [in]

署名するサブジェクトを指定する SIGNER_SUBJECT_INFO 構造体へのポインター。

pSignerCert [in]

デジタル署名の作成に使用する証明書を指定する SIGNER_CERT 構造体へのポインター。

pSignatureInfo [in]

デジタル署名に関する情報を含む SIGNER_SIGNATURE_INFO 構造体へのポインター。

pProviderInfo [in, optional]

デジタル 署名の作成 に使用される 暗号化サービス プロバイダー (CSP) と秘密キー情報を指定するSIGNER_PROVIDER_INFO構造体へのポインター。

このパラメーターの値が NULL の場合、 pSignerCert パラメーターの値は、CSP に関連付けられている証明書を指定する必要があります。

pwszHttpTimeStamp [in, optional]

タイム スタンプ サーバーの URL。

psRequest [in, optional]

署名要求に追加 されるCRYPT_ATTRIBUTE 構造体の配列へのポインター。 pwszHttpTimeStamp パラメーターに NULL ではない有効な値が含まれていない場合、このパラメーターは無視されます。

pSipData [in, optional]

SIP 関数に追加データとして渡される 32 ビット値。 この形式と内容は、SIP プロバイダーによって定義されます。

ppSignerContext [out]

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

戻り値

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

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

要件

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

関連項目

SignerSign

SignerFreeSignerContext